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Watcom C/C++ IdO 


ACCELERATE 

Your C and C++ 
Application Development 


The new Watcom C/C++ 10,0 
development system simplifies and acceler¬ 
ates development of high-performance, 
multi-platform 16- and 32-bit applications. 

Watcom C/C++ 10,0 delivers productivity 
and performance, combining our state-of- 
the-art compiler technology with a new, J 
integrated development environment 
(IDE) and comprehensive set of tools. 

New integrated Development 
Environment and Toots The new ide is 

built to simplify the complexities of real-world 
application development and make it easy to exploit 
the high-performance, multi-platform power of 
Watcom C/C++ 10.0. In a single "project" you can 
build multiple EXEs, DLLs, and LIBs, targeting 
several different platforms. The IDE simplifies each 
stage of development from compiling and linking to 
debugging and performance tuning. The package 
includes versions of the IDE and tools for all three host 
platforms (Windows 3,x, OS/2 2.x and Windows NT), 




OS* 


Watcom C/C++ 10.0 includes a source editor with syntax 
highlighting, a suite ot resource editors , testing and 
monitoring tools for Windows 3.x and NT development. 


Multiple Platforms in a Single 

Package Watcom C/C++ 10.0 supports 
^PSevelopment of applications targeting an 
^Incredible array of platforms: DOS, Windows 
j.x, OS/2 Lx, 32-bit DOS (includes royalty-free 
OS extender), OS/2 2.x, Windows NT, Win32s, 
12-bit Windows 3.x and Novell NLMs. To 
aximize the potential on individual 
latforms, Watcom C/C++ 10,0 extends the 
pabililies of the core, multi-platform toolset 
with platform-specific tools, SDKs and libraries, 
^Thi$ extensive support is amplified by the cross- 
platform capabilities of the IDE and tools, which enable 
uilding applications for a w ide range of target 
environments from any of the host systems. 

he Best Optimization Technology watcom C/C++10.0 

combines both 16- and 32-bit compilers in a single package, providing 
you with the industry-leading optimizing compiler team. PC Magazine 
tested performance of industry standard C and C++ compilers and said: 

*thc fastest executables created during testing came from Watcom C/C++ 12 , 
ersion 9.5, while the 16-bit version of the same compiler produced the smallest 
executables' 7 '. Now; with Watcom C/C++10.0, this competitive advantage is 
delivered with our easy-to-use development environment and tools, 

Watcom C/C++10.0 delivers all this in a single package! 


w integrated development environment 
3d on Windows, OS/2 and Windows NT 
vv .,.prehensive suite of multi-platform 
development tools including debugger, 
browser, profiler and more 

* Professional source editor, resource editors, 
testing and monitoring tools hosted on 
Windows and Windows NT 

* Target Platforms include: 

16 bit: DOS-Windows 3,x -OS/2 1.x 
32-hit: Extended DOS-Windows NT 

• Win32s-OS/2 2.x*32-bit 
Windows 3.x* Novell NLM 

• AutoCAD AD S/AO 1 

Suggested Retail Price: 

Watcom C/C++10.0 CD-ROM Edition . 

( CD-ROM with on-line documentation} $350 

Watcom C/C++10.0 

{CD-ROM wth printed documentation) 


Both 16-bit and 32-bit compilers for C and C++, 
the industry's best code optimizer, faster compile 
times with pre-corn pi fed headers. C++ supports 
templates, exception handling and the Microsoft 
Foundation Class library (MFC) 

Licensed components from: 

• Microsoft Windows 3.1 SDK 

* Microsoft Windows NT SDK 

- Novell NLM SDK v4 0 

•IBM OS/2 Toolkit v2.1 

- Microsoft MFC Class library 

Includes Rational System's D0S/4GW 32-bit 
DOS extender with royalty-free distribution 
Significantly expanded and revised 
on-fine documentation 
And more! 


Watcom Internationa I 415 Phillip Street, Waterloo, Ontario, Canada N2L 3X2 Telephone (519) 866-3700 Fax (519) 747-4971 

■ Price in US rtoitars Does noi include freight and taxes where appiiiatjie Authorized dealers may MU lor Ike St99 Special Ofar is available until Ociouar 31. 1994. Wetcorn and the Liohtni™ Dewra are trademarks ol Waiwm international Corn 
MS/4G Is a trademark oi Rational Systems inc. Other trademarks ate properties ot (heir respective owners ©Copyrtgni 1994 Watcom International Carp. 'PC Ma^uina, March 29.1994 


The advanced mtti-platform debugger accelerates the 
development cycle by increasing the bandwidth between 
you and your application. 


Watcom 

A Powersoft Company 


Upgrades: 

(for owners of Watcom G/G++* or Watcom C/C++'* v9.5) 

Watcom C/C++10.D *.... 

CD-ROM Upgrade Edition $] 49 
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"We chose PVCS because the 
vendors of our new develop¬ 
ment tools recommended it. 
They told us Software 
Configuration Management 
was a necessity for productive 
development on the LAN. 

I'm glad we listened 
to them. PVCS has proven 
to be invaluable. We now 
have superb control over all 
development efforts ." 


The Major Development Tool Vendors Agree: PVCS 
Is Essential for Productive Development on the LAN 


Selected Vendors: 

Borland International IDE 
Oigitalk Team/V 
Gupta Technologies, Inc. 
HP SoftBench 
IBM SDE/6000 
IBM OS/2 
Interactive Unix 
Micro Focus COBOL 
Microsoft Visual C++ 
Microsoft PWB 
Powersoft PowerBuilder 


Leverage Your 
Tool Investment with PVCS 

There’s a reason why all major Client/Server 
and LAN development vendors have formed 
alliances with INTERSOLV. It’s PVCS— 
the standard for Software Configuration 
Management on the LAN. It’s a vital 
ingredient for productive LAN development. 

Every Major Development Tool Vendor Partners with Intersolv 

The list on the left is only partial. PVCS is available in all the environments 
developers work in-today and tomorrow. That means less training-you don’t 
have to learn another SCM tool if there’s a change. That means more efficient 
development and easily enforced standards. It means consistent audit trails for all 
development, and the ability to correct errors and anomalies at any time. 


PVCS Developer s Toolki 


PVCS 

Version 

Manager 


PVCS 

Configuration 

Builder 


PVCS 

Reporter 


PVCS 

Production 

Gateway 


SCO 

SunOS 

SunSoft 


Seiious Application Development Demands PVCS 

The trend is clear. Important applications in your company are moving to the LAN. 
They need the control and reliability that PVCS provides. Your development tool 
vendors know that-that’s why they recommend PVCS. ~ 


Solaris _ 

Symantec C++ IDDE \ TftOVj®V 

And many more... \ | 0 the ■ 

\tfk» / 

i iso 

9000 
White. 
Paper / 

/ Call Today for 1 

' More Information: JL 

800-547-PVCS Ext. 500 INTERSOLV 

The Standard for Software Configuration Management on the LAN 


Inside U.S.A.* 1700 NW 167th Place* Beaverton. OR 97006*503-645-1150* FAX 503-645-4576* E-Mail PVCSINFO@INTERS0LV COM 
Outside U.S.A.* Abbey View*Everard Close*St. Albans*Herts All 2PS*Uni1ed Kingdom'Tel 07Z7 812 81Z • FAX +44 111 B69 804 
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We didn’t say 
COBOL Workbench is the 
best in the world. You did. 
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We’ve always believed Micro Focus COBOL Workbench* 
is the best in the world. Now you’ve confirmed it by unequivocally 
placing it first in the 1993 Compufenvorld PC Software 
\ Brand Pre/erence survey. 

You voted COBOL Workbench as Best Technology 
an< d Easy to Use That's not alL Workbench has also 
won top honors in Price/Performance, Best Documentation, Plan 



to Buy, and most importantly, you chose Micro Focus as the 
company you Prefer to do Business With. According to you there 
was no contest. 

Not surprising really. There is no better technology for 
developing new systems or re-engineering existing applications 


on the workstation. Programmers find Workbench puts them 
directly in control of their development environment, delivering 
quality business applications on time and on budget. 

If it isn’t Micro Focus COBOL Workbench, it isn't in 
the running. That’s not just our opinion, it's yours. 

For your free copy of the 1993 Compulerworld survey, 
or for more information, call 8OO-MF-C0BOL, (800-872-6265). 



Circle Reader Service Number 3 

MICRO FOCUS 

Micro Focus Luc. 2465 East Bayshore Road, Palo Alio, CA 94303, Tet. (415) S56 4161, 
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GSA Contract Number GSOGK93AGS6403, In Canada call IBM Canada at 1-800-465-1234, 
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SourceLink v2.0 

by One Up Corporation 

SourceLink. the ultimate 32'bit programming 
development tool, combines the functionality 
of hyperlink source code access, a fully- 
functional editor and extensive file manipula¬ 
tion utilities Into one very powerful toolset. 

Now you cam find code, change code, spawn 
compiles and hyperlink directly to the source 
of error quickly and efficiently. Features 
point & click source code navigation and automatic generation of 
function call trees. 

List: $299 Ours: $215 TAXcettm #: 6005-0003 



CAREALIZER 

by Computer Associates 


; CA-REAUZEK 


Defines a new generation of development 
tools that handles the mechanics of 
event-driven programming, message passing, 
process sharing and other complexities 
behind the scenes. Combines a structured 
superset of BASIC extended to access 
Windows and OS/2 objects and resources, 

CA-Realizer will help you create spread¬ 
sheets, charts, text editors, animation, 

graphics tablets and user-friendly forms from tools that can be 
created and manipulated by simple commands. 



List: $247 


Ours: $79* FAXrthro #: 1004-0008 


■ While supplies last. 



List: $40 


Window Washer v2*0 

by One Up Corporation 

The latest version of the best-selling 32-bit 
screen saver for OS/2, with full system pass¬ 
word security and the most complete monitor 
bum-in protection available today. Version 2,0 
features many exciting animated effects, digital 
video and audio (plays CD's, MIDI or WAV files 
with program effects!. Also utilizes TIF, GIF. 
BMP, & PCX backgrounds. 

Ours: $29 FAXrff,™ #: 6005-0001 


SMART—Source 
Migration Analysis 
Reporting Toolset 

by One Up Corporation 

Hailed by IBM and other Industry 
leaders as a premier source code 
conversion tool, SMART produces native 32-blt source code for OS/2. 
SMART runs on OS/2 2,1 or above and Is used for the migration of 
C and C++ source code from Windows 16-bit to OS/2 32-blt or 
OS/2 16-btt to OS/2 32-blt, depending upon the licensed, installed 
tables. The result Is a faster, more lightly Integrated application that 
does not require any emulation or run-time modules. 

List: $14,995 Ours: CALL FA Xcttera #: 6005-0004 



WATCOM VX-Rjsxx & 
WATCOM SQL for OS/2 

by WATCOM 

WATCOM " VX"Rexx is an award-whining easy to 
use visual development environment for creating 
applications that leverage the capabilities of 
OS/2 2.x and exploit the Presentation Manager 
graphical user interface. WATCOM’ SQL for 
05/2 is a high performance SQL Cl lent/Server 
DBMS for OS/2 which includes a standalone single-user SQL data¬ 
base server as well as a variety of Interfaces to access WATCOM SQL 
from many popular OS/2, Windows and DOS applications 
WATCOM SQL for OS/2 also Includes a high-level Interface for Rexx. 
allowing easy access from WATCOM VX*Rexx 
applications. Using the VX*Rexx visual design¬ 
er, you can graphically create Presentation 
Manager Interface objects, quickly customize 
their properties, and easily attach Rexx 
procedures to the objects using powerful drag- 
and-drop programming techniques. These pro¬ 
cedures can easily retrieve information from the 
database for use in the application. Key 
features of WATCOM SQL for OS/2 include; 
referential integrity; bi-directional, scrollable, 
updatable cursors; row-level locking; ANSI SQL 
and IBM SAA compatible; multiple simultaneous application connec¬ 
tions; symmetric mu It l-threading of concurrent requests; and the 
ability to import data from popular file formats including DBF. 

SPECIAL BUNDLE OFFERS 

Only: $349 WAXaura #: 1683-0019 




object-Menu 

by Lifeboat Publishing 

obJect-Menu is the wav to quickly create 
powerful object-oriented applications. Built-in 
aesthetics make it easy to create Interface 
styling such as Windows, Motif, or your 
own custom design. Portability to DOS. 

Windows /NT and OS/2 enables you to offer 
your product to multiple target markets with a 
single engineering effort. And, object-Menu's 
Intuitive architecture, straightforward methodology and Visual 
Design tool significantly speed GUI development to allow you more 
time to focus on your application. 

List: $299 Ours: $269 FAXcwera #: 2088-0003 
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r_ Editors 
Comments 


The Pen is Mightier Than 
The Mouse 


n this issue, we will look at a growing set of 
m OS/2 programs that require neither a key- 
m board nor a mouse: pen-aware applications. 
You have probably noticed the growing number 
of pen-input systems in use today—when was the 
last time you were asked to sign your name on a 
computer display? Did you know that OS/2 ts 
pen-aware {thanks to IBM's Pen for OS/2) and 
that your applications can easily be adapted for 
this new market? Here's your chance to find out 
how, thanks to contributors Sarka Martinez, Kevin 
Lee, and Vera DuLaney. 

Pen-aware is fine, but pen-exploitative appli¬ 
cations really open up some possibilities. Nothing 
is user friendly about the trading pits on the floor 
of the Chicago Mercantile Exchange* Ordinary 
hand-helds and ordinary operating systems just 
won't survive the high-pressure, real-time 
demands of futures trading* But OS/2 does just 
fine. Larry Gavin and his Chicago CUBS provide 
an insider's view of a dynamic application. 

OBJECT PROGRAMMING IS HERE 

Our September/October issue will feature object- 
oriented programming. We couldn't wait until 
then to get started, however, so we asked Robert 


Tycast, a long-time OS/2 Developer contributor, 
to tell us about OpenDoc. This evolving standard 
is what object technology is all 
about* It won't be long before we are 
all working with compound docu¬ 
ments—especially those of us in the 
publishing business! IBM, Apple, 
and WordPerfect have already seen 
the future and are hard at work 
making OpenDoc a reality. 
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GUi Corner 


This is the third of a series showing how a replacement list box smashes the 64K barrier and illustrates 
new methods of control design. In this issue, we cover the basics of text editing. By MARK A. BENGE 
and MATT SMITH 


The Forbidden Text 



Matt Smith 


/ n previous columns, we began the 
presentation of a 32-bit replace¬ 
ment to the list box control. We 
mentioned that we would add direct 
editing to the list box. Before we 
attempt to do that, we will take a 
detour into the basics of text editing. 
To illustrate this side trip, we develop 
a replacement to the entry field. If you 
understand the basics of editing text, it 
will be much easier to add this support 
to the list box. 

WHAT'S EVERYBODY AFRAID OF? 

It is extremely difficult to find any books 
or articles that discuss the issue of text 
editing within a graphical environment. 
Just because the default text is propor¬ 
tional doesn't mean we should rim away 
and hide. It's easy to create a text input 
mechanism for fonts of fixed increments, 
like Courier, but what are you supposed 
to do when it is a proportional font? You 
would think that by this time someone 
would have documented the simple—yes, 
simple—tricks that allow you to do it. 

BACK TO THE FONT BASICS 

Why hasn't the issue of text editing been 
adequately documented? Basically, it's 
because each of the letters has a different 
width. Figure 1 shows the fonts used 
within an OS/2 command window. The 


font widths are all the same, and each 
font increment is a multiple of that width. 

Look at Figure 2, which shows the 
system font. Some font widths are the 
same, while others are larger or smaller— 
hence, the big scary monster. In each fig¬ 
ure, the running position is shown across 
the top of the font, and the width of each 
character is shown at the bottom. 

WHERE DID THAT MOUSE GO? 

Let's assume we use the traditional 
method to determine the character 
index based on the location on which 
the mouse pointer was clicked, if the 
pointer was clicked in position 112, we 
would use the following formula to 
determine which character is selected: 

JcOick / CharWidth = Charlndex 
Therefore, 112 / 12 = 9 or the character j. 

What happens if we use this 
formula with a proportionally spaced 
font? If the average character width is 8, 
the formula yields 112 / 8 = 14 or the char¬ 
acter o, which is wrong. It should be the 
character m 

TRANSLATION PLEASE 

What's the trick? The answer is one of two 
methods. The first method, which is the 
fastest but contains a memory overhead. 
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is to build an array of points based on the 
text string. Conveniently there is a func¬ 
tion within the GPI that will do this for us. 

GpiQueryCharStriiigPos is used to query 
the starting point for each character 
within a string passed to the function. 
The points are returned in an array of 
PQXNTL structures that is passed to the 
API. We use this array to determine the 
character position. 

In the previous example, if we 
passed to the function the exact charac¬ 
ter string shown, the points would be 
returned in the POXNTL array, and we 
would only have to look at each array 
element and the next element to deter¬ 
mine if the point is between each. If it is, 
we have found the character. 

The alternate method is to use the 
GpiQueryTextBox or the WinDrawText APIs, 
while at the same time shifting the num¬ 
ber of characters you view. The alterna¬ 
tive, while a memory miser, can be much 
slower, depending on the method you 
implement to perform the calculations. 
Remember, every time you invoke a sys¬ 
tem API, you don't know how many lines 
of code that API will execute. 

The fastest method of performing 


the translation from the point to the 
character index is to perform a simple 
binary search until the character cell is 
located. Both translation methods could 
employ the technique. 

In our replacement for the entry field, 
we employ the first method of using the 
GpiQueryCharStringPos and the binary search 
technique. 

A MATTER OF SELECTION 

How do we translate this into reality 
with the replacement entry field? Quite 
easily, actually. Figuring out the charac¬ 
ter index is a piece of cake; handling the 
selection mechanism is a different story. 

Figure 3 shows the basic design of 
the entry field. In terms of character 
selection, we are concerned only with 
horizontal locations. This is due to the 
nature of the control—that being a sin¬ 
gle line entry field. A simple click of the 
left mouse button causes us to look up 
the character index based on that loca¬ 
tion. One subtlety is how each click is 
translated to the final character index. 

When the mouse pointer is clicked, 
the look-up routine determines the char¬ 
acter over which the click occurred. To 



Figure 1. Fixed font metrics 
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Figure 2 . Proportional font metrics 
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Tales from the Trenches 

A Public Service Announcement: When we started develop¬ 
ing the replacement entry field, we decided to throw in cursor 
management calls. Bad move...or so it seemed. Although we 
specified in the VinCreateCursor call that the cursor should flash, 
it would not flash. For three solid days, we smacked our heads 
against the display, desperately trying to figure out what we were 
doing wrong. We finally figured it out 

We set a breakpoint on the WMJIMER message to see if it was 
intercepting a timer message for the flashing of the cursor. Sure 
enough, the breakpoint was hit. After looking at the timer ID, we 
knew it wasn't one of ours that was set off by mistake. Because of 
the sheer diligence with which we have scoured the Presentation 
Manager headers over the past few years, we understood that this 
idea made sense. Buried within the PMWIN.H header are the IDs of 
four timers used within Presentation Manager. 

One of them is TTD_CURSOR, which was the 10 of the timer we 
encountered at the breakpoint. The solution to getting the cursor to 
flash again? We put in a couple of lines of code that check the ID of 
the timer, determine whether it is the cursor ID, and pass the mes¬ 
sage on through to the WinOefaultVindovProc, Guess what? This 
isn't documented anywhere in the Presentation Manager documen¬ 
tation. If you follow the WM_TIMER reference, you are supposed to 
return zero (0). Maybe the Presentation Manager ID groups are 
spending too much time at the beach in Boca. 


facilitate drag selection, eadi charac¬ 
ter is divided into two zones. The 
front half of the character is used to 
select the character The back half of 
the character is used to select the 
next character. Hence, you have a 
conceptual click zone like that 
shown in Figure 3. 

Why is this done? The answer is 
based simply on boundary condi¬ 
tions. This mechanism makes for a 
smoother selection when clicking on 
a character. It also makes the drag¬ 
ging selection mechanism appear 
smoother. Who said appearances 
aren't everything? 

ANCHORS AWAY 

The selection of text is based on a 
zone with an anchor point. The 
zone starting and ending points 


make sense. What is the anchor all 
about? 

The drag selection of the text 
can be performed in either direc¬ 
tion; left to right or right to left. 
The anchor is the point on which 
the selection zone flips when the 
drag selection changes from one 
direction and reverses to the other. 

This allows the starting and 
ending selection points to be non- 
directional in nature. The anchor is 
always based on the initial mouse 
click position. Therefore, when the 
mouse is dragged from left to right, 
the anchor is, in effect, the starting 
position of the selection zone. If the 
mouse is suddenly dragged from 
right to left and in front of the old 
starting location, the anchor is now, 
in effect, the ending position. 


When you use this technique, 
you ensure a smooth transition 
from one zone to the other. 

Depending on the direction of 
the dragging, the cursor is located 
either at the beginning or the end 
of the selection zone. When drag¬ 
ging from left to right, the cursor 
always ends up at the end of the 
zone (this is where the mouse 
release occurred). The cursor is 
placed at the beginning of the zone 
when the dragging is right to left. 

CHARACTER REFERENCES, PLEASE 

You can perform different opera¬ 
tions on this selection zone. The 
most common action is deleting 
selected text and replacing it with 
a text string {a paste operation) or 
a single character (a keyboard 
character keystroke). You also 
could cut or copy the selected text 
to the clipboard if you desire. 

By default, the entry field 
begins in insert mode. When no 
selection zone is active, the cursor 
location becomes the focus of 
interest. Any text pasted into the 
entry field causes the text to the 
right of the cursor to be pushed to 
the right. A simple character key¬ 
stroke from the keyboard achieves 
the same result. 

When the entry field is in over¬ 
type mode, the character posi¬ 
tioned immediately after the cur¬ 
sor is selected. If a character 
keystroke is performed, the 
selected character is replaced with 
the new one. 

SCROLLING THROUGH THE PARK 

Once we have the basics in place, 
the fun begins. Usually, when you 
perform drag selection, you need 
to force the text that is not dis¬ 
played to be shown. 

The most often used technique 
is to move the mouse pointer to 
the left or the right of the entry 
field, while the left mouse button 
is continuously depressed. Once 
outside the left or right limits, the 


8 


OS/2 DEVELOPER 







PRESTO! A PRACTICAL 
CLIENT/SERVER SOLUTION! 


Introducing GLS-Pre$to 2.0. 

Now you can build state of the art OS/2 and Windows 
applications for hundreds and even thousands less* 

Presto is the only client-server development tool which 
generates OS/2 and Windows applications in COBOL, C 
and C++, for one low price. 

Presto is designed to help you become a client/server 
magician as quickly as possible without compromising on 
power, flexibility and security* 

With Presto there is no need to invest in proprietary technol¬ 
ogy or suffer through an extensive learning curve* Presto 
allows you to take advantage of COBOL, C, C++ and SQL 
while effectively isolating you from the complexities of 
client/server development* 





Presto’s intuitive, easy to use integrated development 
environment will have you performing client/server tricks in 
no time at all. Design, prototype, generate, test and debug 
without ever leaving the IDE* 

Presto makes the difference between OS/2 and Windows 
disappear, and lets you take advantage of the best of what 
they have to offer. For example, Windows MDI support is 
included for OS/2 and OS/2 control types may be used 
within Windows. Simply define your application, then 
select the target environment when you are ready to gener¬ 
ate. Presto does the rest. 



■ Create complex applications in a minimum of time and 
run them under OS/2 and Windows. 
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* Incredibly fast. Applications generate in seconds. 
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idea is to allow the scrolling of the 
contents of the entry field in that 
direction. 

What happens when the 
mouse isn't within the entry field 
window? In our previous article, 
"Scrolling Through the Park" 
(Winter 1993), we discussed the 
technique of capturing the mouse 
using WinSetCapture, such that when 
the mouse is outside the confines 
of our window we still receive the 
movements of the mouse pointer* 
But what if the mouse isn't mov¬ 
ing? Tick, tock, tick, tock..* 

Yes, we rely on a timer that we 
start for the scrolling. Here, we are 
performing more magic tricks* 

When we start the scrolling 
through the timer, we use a 
slower time period* Once the first 
timer message for the scrolling is 
received, we halve the time so 
that the scrolling seems to imme¬ 
diately speed up. This effectively 
gives the drag selection a 
smoother look. 

SHOWING OFF 

It is difficult to display the selec¬ 
tions within the entry field* Here, 
different conditions apply. Re¬ 
ferring again to Figure 3, notice 
that the text is divided essentially 
into three display zones* The first 
part is displayed normally. The 
second part is displayed with 
highlighting. And the last part is 
shown normally 

Unfortunately, there is no API 
within OS/2 Presentation Manager 
that allows us to display text in this 


fashion (but we wish there was!). 
You must design the display rou¬ 
tines so they subdivide the text into 
the three component parts, such 
that the drawing appears sequen¬ 
tially. If you don't do this, you may 
get a rougher drawing of the text in 
which portions appear to flash. 

When you take into considera¬ 
tion the effects of offsetting the 
starting point of the scrolled text, 
things do become very interesting* 
Basically, the drawing compo¬ 
nents of the entry field are divided 
into different drawing routines* 
Each routine is designed for speed 
instead of a general purpose engine. 
Since it is so frequently used, 
this area can be continuously 
reworked so that every ounce of 
power is squeezed out. 

WHAT, YOU DONT LIKE 
THE MULTILINE EDIT CONTROL ? 

With this entry field replacement, 
you now have the basis to imple¬ 
ment many different editing compo¬ 
nents. In our column that will 
appear in OS/2 Developer's Novem¬ 
ber/December 1994 issue, we will 
take the principles of the entry field 
and apply them to the list box. 

How could we further enhance 
this control? What about replacing 
the multiline edit control? Rather 
than replace it by providing exactly 
the same functionality, we could 
provide an enhanced entry field 
that can handle multiple lines. 

This latter approach seems to 
make more sense. Here, you would 
just rely on the idea of \n separat¬ 


ing each line within the control* 
The scroll bars could be provided 
to allow scrolling similar to that 
found in the multiline edit control. 

By providing a few messages 
and allowing the entry field to have 
additional lines, you could easily 
create your own multiline edit con¬ 
trol without much grief. It's easy 
now that you know how to trans¬ 
late that mouse click into a charac¬ 
ter selection* 

In a future column, we will 
provide answers to your Pre¬ 
sentation Manager programming 
questions. If you have a problem 
you would like us to address, 
please contact us at our e-mail 
addresses* 

Mark A* Benge, IBM Software Solutions, 
Cary, N£. t is a staff programmer who joined 
IBM in 1989 and has worked on various CUA 
91 controls for OS/2 2.x. He works in IBM 
user interface class library development 
where he was involved in the implementa¬ 
tion o f C++ classes for drag and drop in C 
Set++ 2.1. Benge has a B.S. in computer sci¬ 
ence from Western Carolina University. He 
can be reached on CompuServe at 
73532,2063 and on Internet at 
banzai@vnetibm.com. 

Matt Smith, Prominare inc„ Toronto, Ont, 
Canada, is lead architect for the Prominare 
Development System , an OS/2 2.x 
advanced GUI development environment. 
He has been actively involved with OS/2 
since 1988 and cofounded Prominare in 
1990[ Smith has a degree in architecture 
from the University of Waterloo . He can be 
reached on internet atprominario.org. 


REFERENCES 

You can download EDCTL1*EXE from 
these electronic sources: 

CompuServe's OS2DF2 forum 
{OS/2 Det*ehper section). 

File area 1! on the IBM PCC BBS, 
(919) 517-0001. 

OS/2 tools section on OS/2 BBS 
for IBM TALKLink customers. 
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Now, all the C/C++ development tools 
you need come in one handy package. 



Bonus Bundle: C Set ++ CD-ROM, OS/2 for Windows, 
KASE:Set and Experience C++.«just $249! 


If you want it all, you've come to 
the right place. IBM C Set ++ 1U 
Version 2.1 is the most 
co mpre h e nsive C/C++ 
development pack age you can 
buy for OS/2*. Period. 

C Set ++ can dramatically slash 
your programming time with an 
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world-class optimization. Your 
applications arc quick to build, 
fast to execute and easier than 
ever to modify. 

C Set ++ brings you the most complete set of class 
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* A User interface class library and Collection Classes 

* Visual debugger and Execution Trace Analyzer 
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...everything you need to make C/C++ development 
faster, easier and more hassle-free than ever before. And 
where C Set ++ stops, our 24 hour comprehensive IBM 
service and support begins. We're on call, when you call. 



Now, when you pun base the C Set ++ CL+ROM. you will 
also receive OS/2 For Windows™, the KASE:Set™ 
GUI-builder and the revolutionary Experience C++ 
tutorial... all for just $249. 


KASEWORKS™ KASEsSel provides an introductory 
level GUl-builder, speeding the pace of your 
developments... and your learning. 


ORDER TODAY 



Experience C++™ is the only leading-edge 
multimedia tutorial that lets you look and listen to 
detailed 
descriptions of 
every aspect of 
C++. To order 
your C Set ++ 

Bonus Bundle 
call our toll-free 
order hotline 
today! 


1 800 342-6672 



For Ite IBM C Set ++ for OS/2 CD-ROM 
Version 2.1. 

CD-ROM with hardcopy documentation is 
availabte (or $279. 3.5’ disks with hardcopy 
doaimontalKHi are available lot $303. 


(0 1994 Inaematiofiffl Business Machines Corporation 
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A natural gas company discovers that moving to OS/2 doesn't mean abandoning years of COBOL 
experience. By BRIAN PROFFIT 


Utility Company Adds 
Power with OS/2 



Brian Proffit 


W ow do you update ancient main¬ 
frame COBOL environments to 
provide better productivity and 
lower maintenance costs? This is a prob¬ 
lem many companies now face. Questar 
Service Corp., which provides informa¬ 
tion technology services to all branches 
of the Questar Corp, holding company, 
knew it needed to make changes. But 
going from a 3270 environment to a 
client/server solution with no down¬ 
time and minimum risk is challenging. 


Over time, of course, Questar 
patched and added to the system. 
Maintenance became a nightmare, Jerry 
Edwards, director of Data Processing, 
reports that maintenance alone was 
costing around $2 million per year, 

"Adding five characters to an 
address field required changing over 
300 programs, took nearly a year, and 
cost a horrendous amount of money," 
Edwards says. Clearly, a change was 
needed. 


CUSTOMER INFORMATION SYSTEMS 

For utility companies, customer informa¬ 
tion systems are key. Questar's customer 
information system covers straightfor¬ 
ward name and address information kept 
by other industries. It also covers other 
aspects of the natural gas industry neces¬ 
sary for servicing more than a half-mil¬ 
lion customers in the northwest from its 
Salt Lake City headquarters, Questar 
Service employs over 200 people to han¬ 
dle the data processing needs of this orga¬ 
nization. Since 1966, its customer infor¬ 
mation system has grown to over one 
million lines of mainframe COBOL code, 
covering data access and manipulation 
functions for customers, natural gas dis¬ 
tribution, marketing, accounting, and the 
maze of required government regulatory 
information. 


NEW DEVEL 0PMENT PROCESS, 

NEW BUSINESS PROCESS 

In analyzing the existing spaghetti code, 
Questar discovered that the developers 
alone couldn't be blamed. Like most 
companies, Questar's business 
processes had also been added to and 
patched over time, leading to needless 
complexity and duplication of effort. To 
develop a clean, new information sys¬ 
tem, it also made the commitment to 
reengineer its business. 

This decision made changes even 
more risky. By moving users from one 
system to another, Questar faced many 
potential problems, such as user diffi¬ 
culties and bugs, during the break-in 
period as the new code was exercised. 
Changing the business process at the 
same time doesn't double the risk; it 
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squares it. To lower the risk, Questar 
chose to migrate to the new level one 
piece at a time. 

"'We looked at the 54 subsystems 
containing around 700 programs and 
broke the whole project down into 
chunks that could be written and 
tested in no more than 90 days/' 
Edwards says. "That way, the changes 
to the users would come in small, man¬ 
ageable pieces, and we could reengi¬ 
neer the business at the same time/' 

For the business changes, Questar 
decided to learn from the best. "We 
looked at companies all across the 
country to see how they did things/' 
Edwards reports. "At each phase, we 
implemented the best technique we 
had found among them—changing the 
way the business did the process 
before we introduced the new technol¬ 
ogy. We redo things to remove duplica¬ 
tions, for example. That has cost-justi¬ 
fied the project all by itself/' 

This migration technique helped 
dictate Questar's choice of PC plat¬ 
form. "We looked at Windows, OS/2, 
OSF, and X Windows/' recalls 
Edwards, "We found that Windows 
just didn't have the horsepower and 
wasn't robust enough for a mission- 
critical application. Plus, the response 
time wasn't sufficient, nor was the 
crash protection. We didn't feel that 
OSF or X Windows was going to be 
mainstream enough. 

"We decided on OS/2 for several 
reasons. A big [reason] was its ability 
to run DOS software so well. That 
allowed us to continue running our 
3270 emulators well while users began 
using OS/2 programs," 

They're also exploiting OS/2's 
ability to run programs written for 
DOS and Windows in other ways. For 
example, they've developed a new 
Executive Information System using 
Visual Basic. 


"We have automatic links to Dow 
Jones, getting stock information every 
hour automatically and doing graphic 
comparisons/' says Edwards. "We also 
get weather information and satellite 
maps because parts of our business are 
weather-sensitive. We integrate [the 
information] right into our system. We 
have a tie-in to automated news ser¬ 
vices, retrieving articles related to our 
industry. We can cut-and-paste those 
into our word processor or e-mail. The 
QS/2 architecture is giving us benefits 
we hadn't anticipated. Of course, just 
being able to do something else while a 
compile is running helps a lot/' 

OLD SKILLS, NEW TOOLS 

Questar decided that, although it was 
revamping its software and business, 
changing everything didn't make sense. 
"We estimated it would have cost an 
additional half-million dollars in retrain¬ 
ing costs if we were to change from 
COBOL to C. Then you have to factor in 
the huge amount of additional time, 
personnel problems, and risk of using 
code from programmers not familiar 
with the language." 

By 1992, Questar had the tools in 
place that allowed it to take advantage 
of its programmers' comfort level with 
COBOL. One tool they used was the 
MicroFocus Workbench, an integrated 
development environment with several 
functions designed to help these 
migrations. For example, the Work¬ 
bench can automatically convert 
EBCDIC to ASCII as mainframe code is 
brought to the workstation. 

An important aspect of the change, 
however, was the greater productivity 
a consistent graphical user interface 
could bring the user. Questar wasn't 
interested in just bringing batch code 
to the workstation. But learning the 
Presentation Manager API and COBOL 
bindings sufficiently to produce high- 
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quality code would have taken 
more time and training than 
Questar wanted to undertake. 
Another MicroFocus tool solved 
the problem. 

"'We use Dialog/2 to develop 
all of the GUI front ends/ 
Edwards says. "We evaluated 
[Kasework's] KA$E:PM for 
COBOL but didn't see a reason to 
bring in another vendor. Dialog 
lets us paint screens with the user 
sitting right beside us. When the 
user is happy with the layout, 
Dialog generates a 'screen set/ 
which we compile into our pro- 
grams. Acceptance of the new 
software has been high because 
the users helped design it. They 
can see what they're getting in 
advance, rather than talking 
about it, waiting five or six 
months, and having something 
thrown at them. 

"We've worked with some 
CASE tools that had horrible learn¬ 
ing curves, but this one was pretty 
quick We had mainframe COBOL 
programmers producing GUI front- 
ends within a week. The program¬ 
mers took to the change really well. 
There were people who had been on 
mainframes for a long time who 
had a little trouble. We had some 
people who do outside program¬ 
ming and use MicroFocus COBOL 
on the PC, so we had a head start." 

However, they aren't integrated 
with the Workplace Shell because of 
the dependence upon Dialog/2, 
MicroFocus hasn't included support 
for features such as notebooks and 
drag-and-drop, and Questar has 
decided to wait rather than plunge 
into OS/2's API. Still, the combina¬ 
tion of better tools and the move to 
a different development methodol¬ 
ogy brought significant dividends. 

For example, Edwards esti¬ 
mates that the move to a consis¬ 
tent GUI interface has cut training 
costs in half. "The commonality 
and consistency of [Presentation 
Manager] makes it easier to train 


users on the system. We can move 
people from job to job, and they 
can pick up the new computer 
programs easily. We credit the 
improved user interface with the 
fact that payments are now 
posted 24 hours earlier." 

This wasn't entirely due to 


sticking with the Common User 
Access (CUA) standard. When 
queried if Questar's programs 
conformed to the CUA specifica¬ 
tion, Edwards asks with a laugh, 
"Which one? We started off trying 
to adopt CUA, but we strayed a 
bit." 



Figure 1 . The old business process was as much of a patchwork as the code 



Figure 2 . Both business and software benefit from re-engineering 
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MAINFRAME AS FILE SERVER 

The old, flat file structure was a 
large part of the maintenance dif¬ 
ficulties because it didn't offer 
much flexibility, Questar felt it 
could salvage its knowledge of 
CICS but needed to move to DB2 
databases, 

'"We wanted to set up a coop¬ 
erative link between C1CS/MVS 
and the workstation/' Edwards 
says, "One of the reasons we 
selected OS/2 was the ease with 
which CICS/OS2 could be linked 
with the mainframe. We came up 
with a strategy to [use] intelligent 
workstations [and] the mainframe 
as a file server* The PCs are 
Compaq 486 workstations that 
access a seven gigabyte DB2 rela¬ 
tional database on the host/" 

Currently they have approxi¬ 


mately 700 PCs on 26 NetWare 
LANs connected to the Amdahl 
mainframe via a WAN. Managing 
the development and distribution 
of software across an environ¬ 
ment like this can be a headache, 
Questar uses IBM's Netview 
Distribution Manager to handle 
this and reports success, 

MEASURING THE BENEFITS 

"We have moved to small, inde¬ 
pendent development teams," 
says Edwards, "Having each 
piece small enough to complete in 
60 to 90 days has helped them see 
faster results. That helps morale. 
Programs are coming in ahead of 
schedule and under budget. 
Development time has been 
reduced dramatically. What typi¬ 
cally would have taken 600 to 700 


developer-days is now down to 
200. That lets us be more respon¬ 
sive as things change. For ex¬ 
ample, we have just decided to 
build systems for natural gas 
vehicles. We can have it com¬ 
pletely implemented in three to 
six months. 

"The [Presentation Manager] 
code is easier to maintain than the 
mainframe code. Plus, the change 
in development methodology cut 
down on maintenance. We're 
finding fewer fixes—partially 
because the user is helping with 
the design and partially because 
the quality of the tools allows us 
to build things with fewer bugs." 

Edwards describes the four 
keys to Questar's success as new 
methodology, new tools, new 
team concept (with greater auton- 
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omy), and a new management 
strategy. In fact, Questar was 
nominated for an Ultra Award— 
an honor bestowed on utility 
companies demonstrating signifi¬ 
cant technical innovation. Ed¬ 
wards was recently asked to dis¬ 
cuss Questar's move to OS/2 at a 
customer information system con¬ 
ference sponsored by Price 
Waterhouse in Orlando, Fla. 

"There was a lot of interest," 
Edwards says. "There are around 
20 utilities [companies] that 
would like to come visit us and 
see what we're doing. A division 
of Questar is considering starting 
a consulting service/' 


MORE WORK 
BUT FASTER RESULTS 

The dramatic decrease in devel¬ 
opment time occurs even though 
Questar's technique demands 
more development effort. "We 
have made a commitment to keep 
the data in one place," Edwards 
says. "One of the advantages of 
OS/2 is that it allowed us to write 
some behind-the-scenes code to 
pass information between 3270 
sessions and our OS/2 programs. 
Migrating small pieces has 
required us to build bridges 
between the pieces of data on the 
workstation and the pieces on the 
host. We still think that is better 
than having duplicate informa¬ 
tion. As we implement new 
pieces, we add new bridges and 
tear down some that are no 
longer needed. That is one of the 
hardest parts." 


EASIER TRAINING 
AND SUPPORT TOO 

Questar has 18 offices running 
OS/2 workstations. Training and 
supporting users meant traveling 
to remote offices for tasks that 
required visual access to the user's 
computer. IBM's Distributed 
Console Access Facility/2 made a 
significant difference in the num- 
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Figure 4 ; Dramatically faster order processing linked with mobile terminals 


ber of trips required and the dura¬ 
tion of phone calls needed for 
troubleshooting. 

"From 500 miles away, I can 
bring up a view of [a remote] sys¬ 
tem's display," Edwards says. "In 
fact, I can bring up more than one 
person's screen at the same time 


in different windows. This lets 
[me] set up a conference call and 
monitor their system." 

EXTENDED CONNECTIVITY 

Questar has extended connectiv¬ 
ity beyond its WAN. The com¬ 
pany has a number of field per- 
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sonnel handling distribution of 
natural gas. The information in 
Questar's customer information 
system is accessible from 
the field via 135 mobile data 
terminals. 

In fact, the mobile data termi¬ 
nals are processing over 8,000 
transactions per day and have 
allowed Questar to reduce its dis¬ 
patching personnel, saving about 
$100,000 per year. 

The mobile data terminals are 
a key reason why Questar cannot 
afford any downtime. They access 
the customer information systems 
24 hours a day This enhanced con¬ 
nectivity is also enabling better 
workload forecasting and schedul¬ 
ing of service orders. 

THE MOVE CONTINUES 

Questar is finding several new 
possibilities that the OS/2 work¬ 
stations offer. For example, the 
engineering department is using 
an Intergraph computer mapping 
system. Questar is now integrating 
that into the Customer Information 
System, allowing access to over 
5,000 maps. 

Questar is taking advantage of 
Win-OS/2 functions as well, using 
Microsoft PowerPoint and Excel 
and WordPerfect for Windows. 
Questar is also evaluating Pioneer 
Software's Q+E query tool as a 
way of providing easy access to its 
database. To Edwards, this flexibil¬ 
ity is key 

'"We're strongly committed to 
OS/2, but that doesn't mean we 
can't run Windows applications on 
it OS/2 is our lifesaver, allowing 
us to migrate and run the old and 
new at the same time," 


Brian P raff it was part of IBM Corp. 1 s 
OS/2 development team before leaving 
to become director of PC Week 
Corporate Labs . Proffit is currently presi¬ 
dent of Visionary Research, an indepen¬ 
dent consulting firm. He also is the 


m Extend LANs transparently over 
asynchronous modems to remote 
workstations and workgroups. 

■ Run DOS, Windows? Sc OS/2™ apps written 
to multiple protocol stacks on remote nodes. 

■ Operate remote computers as full-function 
LAN nodes. 


author of two books f OS/2 Application 
Development Tools and OS/2 Inside and 
Out. Proffit is a contributing editor for 
OS/2 Magazine and has written for PC 
Week, Dr. Dobb's Journal, and 
Programmer's Paradise, 


■ Connect to remote offices with LAN-to-LAN 
dial-up networking. 

m Add remote connectivity services using 
existing UN machines. 

■ Access remote PC serve* ami hosts without 
additional host gateways. 

■ Up to 64 ports on a non-dedicated server 


RemoteVision makes it easy and affordable for DOS, Windows and 
OS/2 users in remote locations to connect to Token Ring or other LANs 
using dial-up modems. Response time remains fast, applications don’t 
need changing, and users won't need retraining. So you can turn your 
remote machines into full-function workstations. With RemoteVision. 
To immediately find out more, or to take advantage of our “Try Now, 
Pay Later” 30-dav money-back guaranteed trial offer, call today. 
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Don’t even think about using a 
Relational Database System ! 




Use the POET Object Database for C + + 


C+ + and class libraries have made the GUI development much 
easier. After all, it is only logical that more and more developers 
think in objects. But object orientation shouldn't end at the user 
interface programming level. 

The Problem: Without POET, a C + + programmer must ose flat 
files or a RDBMS to store objects. He has to write code to over¬ 
come the mismatch between the application and the database 
model. This leads to design restrictions, performance penalties and 
more code to write and maintain. 

The Solution: POET operates at the object level, it speeds up the 
development process and provides greater performance. Further¬ 
more, the developer can simply take the object-oriented applica¬ 
tion design in C+ + and map it 1 to 1 into the database. Without 
any compromise at all! 


Full featured 
database: 

POET provides 
complete support 
for Encapsulation, Inheritance, Polymorphism and Containers as 
well as queries, object locking, and transaction handling . 

True cross platform support: Complete interoperability makes 
the development of network enabled applications a breeze. POET 
supports Windows 3.1, Windows NT, Win32s, Windows for 
Workgroups, Novell Netware (NLM), SUN, AIX, HP-UX, SGI, 
SCO, Macintosh, Power Macintosh, OS/2 and NeXTStep. 

Call 1'800-950-8845 
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Programming Insider 


Feeling a little Shell-shocked after last issue? This issue's Programming Insider finishes up in getting you 
on your way to writing effective Workplace Shell-exploitative code. By DAVID REICH 


More InSOMnia and 
Workplace Shell Programming 



David Reich 


M m leeping better since last issue? 
Hopefully the Programming In- 
sider column in OS/2 Developer's 
May/June 1994 issue helped you under¬ 
stand more about how 05/2's Workplace 
Shell fits in with OS/2 and running appli¬ 
cations, In any event, this column takes 
that basic program a step further 

When I finish with these descriptions, 
you'll have an object that knows its type, 
its association types, and its icon. Also, 
the object will start the appropriate print¬ 
ing function when it is dropped on a 
printer object You don't have to code all 
the function into the object, such as hav¬ 
ing it open, load, and print a data file. The 
object inherits some behaviors from the 
parent class, which I detailed last time. 

In the last column, you saw what 
Workplace Shell objects can do and how 
you should use them, such as not writ¬ 
ing an application as an object, but writ¬ 
ing the object to represent the data to be 
manipulated by application programs. I 
also covered how the Workplace Shell 
fits into the OS/2 system in a large, 
complex, integrated application that 
was written using SOM. 

You read about the basics of SOM 
and the SOM compilers and emitters, 
and how you derive everything from 
the .CSC file initially. From there, we 
took a trip into a small .CSC file that did 


little but show how the files interrelate 
and provide an object to install and try 
out. I provided the WAKE file and a small 
piece of code that shows how to install 
an object. 

THE CODE 

Figure 1 contains the complete .CSC file 
for this object. For those of you who 
missed my last column, I will review the 
whole .CSC file and discuss the change 
from last time, which is the addition of 
the methods that are overridden. 

After that, we'll take a look at the .C 
file shown in Figure 2. If you coded the 
example from the last installment and 
ran HAKE on it, you noticed that the .C file 
is generated for you by the SOM emit¬ 
ters. However, it looks empty, much like 
a window procedure that does nothing 
but call Win Defy indowProc for every mes¬ 
sage. In the .C file here, 1 added some of 
the filling. I will take you through the X 
file function (or method) by function, 
describing what each does. 

Then, you'll be ready to hack at your 
own objects and see what Workplace 
Shell can do for you. 

THE.CSC FILE 

The .CSC file is where it all begins. This 
file is the primary input to the SOM 
emitters. Depending on the SOM emit- 
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ter options you choose, many files are 
output. The most important output files 
are the C, H, and DEF files that, at the very 
least, are needed to build the DLL that 
will be the class. 

Last time, the .CSC file contained 
only enough to define the class and 
show one example of a method to 
demonstrate what the .C file will look 
like. Now, the .CSC file in Figure 1 has all 
the method overrides to perform the 
basic level of work for any object. 

At the beginning of the file is the 
♦include statement for the parent class, in 
this case, UPDataFile. Following that is the 
class definition section with the class 
name, class hierarchy, and stems for the 
emitters (which will become apparent as 
we examine the .C file). 

The formal parent declaration and 
the passthru section follow those sec¬ 
tions. The passthru section is used to tell 
the emitters to pass the section straight 
through to the ,H or .IH file (as specified 
in the passthru section declaration). 

The other sections of the .CSC file 
define the instance data for the object (in 
this example, there is no need for 
instance data) and the methods. The 
methods section defines methods intro¬ 
duced by this object class, along with 
the methods the class overrides. 

For this example, there are no meth¬ 
ods that are introduced. You will notice, 
however, that there are two functions in 
the .C file that are not method overrides. 
Since the functions are not exported as 
methods, no other Workplace Shell 
object can invoke them. For this reason, 
they are private functions to the class. 

The overrides are listed with 
instance method overrides first; class 
method overrides follow. Also note that 
there is a special tdefine in the .C file 
delineating the separation of instance 
and class methods. Since any new meth¬ 
ods in the ,CSC file will cause the .C file 
to be appended to when the SOM emit¬ 


ters are rerun, you must move the decla¬ 
rations for new instance methods above 
this ttdefine. Otherwise, your class will 
not function correctly 

THE X FILE 

The ,C file appears in Figure 2. WeTl 
look at the file function by function (or, 
more precisely, method call by method 
call). Before we get into the -C file, I'll 
recap what this object does. 

The object is part of a mythical 
word processing package. The object 
class has a name and an icon. When a 
new instance of the class is created, it is 
associated with the executable pro¬ 
gram; when it is dragged over and 
dropped on a printer object, it will 
invoke the print code, passing it a flag 
to indicate not to show anything but to 
start up in "subset" mode to print the 
document. In addition, this word-pro¬ 
cessing document object class imple¬ 
ments style sheets. There are several 
ways this can be done, and I include 
one in this example, 

LETS SEE WHAT THIS X FILE IS AND DOES 

First is the section for defines, includes, 
and various pragmas. Don't be afraid of 
these statements, although you may not 
ordinarily use them. The SOM emitters 
put most of them in there. The first few 
lines should look familiar. They are the 
define you set up in the .CSC file and 
some basic Presentation Manager 
includes. Then there is a function decla¬ 
ration that is internal to our class: 
SetTypeEL 

Next is a set of lines, added by the 
SOM emitters, that suspend the output 
of compiler warnings and include the 
.IH file. The reason for the suspension of 
warnings is that the prototypes in the 
.IH file can cause compiler warnings. Be 
aware that the suspension of these 
warnings can mask real warnings in 
your source, so you may want to run the 


JULY /AUGUST 19 9 4 


IB 


file through the compiler once 
without warnings suspended to 
see that you are not hiding any¬ 
thing that may be a problem later* 

INSTANCE METHODS 

First are the instance methods* 
These are the methods that the 
instances of the class respond to, as 
opposed to the class methods that 
the class responds to* 

vpPrintfJbject 

The vpPrintObject method is 
invoked on an object whenever it 
is dropped on a printer object. The 
default, or parent class's behavior 
for wpPrintQbject, is to put up a dia¬ 
log box that asks the user if the 
data file {the parent class of our 
class) is a plain text file or a 
printer-specific formatted file. If, as 
in our word processor's case, the 
file is neither, allowing the parent 
class's method to handle it will not 
enable drag-and-drop printing* We 
need a different approach. 

If the data file format you use 
is neither plain ASCII nor printer- 
specific, and you want drag-and- 
drop printing, you will need to do 
some work. That work, however, is 
not very complicated* As outlined 
in the comments of this sample 
object .0 file, you will need to call 
ypQueryRealName against the object to 
get the real file name the object 
represents. Then you will invoke 
the printing code of the applica¬ 
tion, passing that file name and 
some flag indicating that the appli¬ 
cation should print the file, but not 
show itself, and terminate upon 
completion* 

One way to do this is to call 
DosExecPgm and invoke the applica¬ 
tion. Another way to accomplish 
this is dependent on the architec¬ 
ture of the application; but if you 
separate the printing code into a 
function or set of functions in a 
DLL, you can export the print 
interface from the DLL and call it 
from your object directly* 



figure 7. The new object's complete . CSC file (continued on page 24) 
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BREAK AWAY FROM THE COMPETITION 



t When you’re pressing the limits of soft- 
ware performance, every microsecond 
r ~ counts. Efficient operation decreases exe¬ 
cution time, putting you ahead of the pack. 

That’s why professional C/C++ developers 
use High C/C++". MetaWare’s High C/C++ com¬ 
pilers offer eight levels of global optimization, plus 
specific optimizations for particular processors. The 
executables consistently out-perform competitors in 
benchmark testing. 

Besides offering rapid execution time, 
MetaWare’s High C/C++ compilers provide a myriad 
of controls that allow you to customize and fine-tune 
code generation. There are command-line toggles 
and pragmas for customizing your application. 


Dhrystone 2.1 



The compilers generate informative error and warning 
messages, and comply with major industry standards. 

For years, MetaWare 
has supplied major OEMs 

C++ 

Assign object* su ch as AMD, AT&T, 

CenterLine, IBM, Intel, and NCR, with 32-bit compilers 
for a variety of different processors and platforms. 
These OEMs depend on MetaWare for superior 
products and support 

Call (408) 429-6382, or email: techsales@ 
metaware.com, for more information about features 
and specific platforms. 


MetaWare 

Htgh C/C++ for OS/2. NT. DOS. Windows, AIX, UNIX SVR4. and Solans 


"Benchmark source and other performance information available upon request All benchmarks use the -0 option. 

MetaWare. 'he MetaWare logo. High C, and Professional Pascal, are registered trademarks, arc High C/C++ and High C++ are trademarks, of MetaWare Incorporated. 
Other names are trademarks of their respective companies. Copyright igg4 MetaWare Incorporated, 2161 Delaware Avenue, Santa Cruz. CA 95060-5706. 
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The method that uses 
DosExeePgm is the simpler of the two, 
both architecturally and program¬ 
matically. In it, you just call 
DosExeePgm and pass the information 
that is required. However, the DLL 
method is slightly more compli¬ 
cated and requires more work. 

The reason 1 advocate the DLL 
method instead of the DosExeePgm 
method of printing is because the 
former is much faster and easier on 
system resources. You export your 
printing function from the DLL 
and code it so that you can pass a 
file name and flag to this exported 
function. Then, rather than starting 
up a whole new process with 
DosExeePgm, you will call the func¬ 
tion in the DLL. Here, either you 
need to spawn a thread to call the 
print function or write the print 
function so that it starts its own 
thread inside the DLL to do the 
printing. If you do not do this, you 
will tie up the shell's thread doing 
your printing and, therefore, hold 
up processing in the shell. 

Once the print job is spooled, 
you can terminate the program or 
function and return to the object, 
where you execute a return that 
ends the method override. 


vpSetup 

The upSetup method is called when 
an object instance is created. You 
can view it as a WM.CREATE message 
in a window procedure. It lets you 
set up specific settings along with 
the object at creation time. In this 
example, I set the .TYPE extended 
attribute for the physical file. 

To set the .TYPE extended 
attribute, you only need to define 
what the physical file name is and 
what the .TYPE should be. You do 
the former by calling ypGetRealName 
against the object itself. Once that 
is complete, you call the object class's 
class method for QuerylnstanceType 
(mynO.ypclsQuerylnstanceType), which, 
as you will see in a moment, is 
defined to return My Object Document. 



Figure 1 . The new object's complete . CSC file (continued on page 25} 
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Figure 1, The new object's complete . CSC file (continued from page 24) 



Figure 2. Sample object's . C hie (continued on page 28) 


The extended attribute is needed 
to enable the associations. This is 
so the associations work properly 
when using the shell functions 
natively and from the ASSQCTABLE in 
the program executable file. 

Now you have the file name 
and the value to be set in the 


extended attribute. SetTypeEA, the 
internal function defined at the 
bottom of the program, will 
accomplish this. 

The other two overridden 
instance methods, vpCreateAfiother 
and ypCreateFrorriTemplate, are over¬ 
ridden. This is because you should 


control that creation no matter 
what action the user takes to create 
a new document. 

ypCreateJtnotber 

The wpCreateAnother method is called 
when the user creates a new class 
instance by selecting "Create 
Another" from the context menu 
from another document object. 
When a user creates a new in¬ 
stance in this manner, you should 
have control over how the object is 
set up. 

Whenever a new document is 
created in my word processor's 
world, I want to provide a dialog 
to the user, giving them a choice of 
style sheets. (You can do whatever 
initialization you like in here.) You 
can implement style sheets in any 
way you want, I recommend that 
you put up a file dialog, prompt¬ 
ing the user for a file for use as a 
style sheet. In this way, you pro¬ 
vide the flexibility of using any 
valid file as a style sheet; the user 
simply chooses it when creating a 
document through the Workplace 
Shell. You may also add a selection 
for no style sheet if you want. This 
is all up to you. The point is that 
you are performing some setup 
whenever the user creates a new 
instance. 

To easily provide this style 
sheet selection, write a function 
that performs it. You will likely 
need to call it from multiple places, 
given the variety of ways you can 
create a new object instance. 

PutUpStyleSheetDialog, a func¬ 
tion that contains DosBeeps for 
demonstration purposes, is cal¬ 
led inside the override to 
wpCreateHnother. However, this is 
done after a call to the parent 
method. This is so the parent 
method can actually create the 
instance. Then, our function takes 
over to put up the style sheet dia¬ 
log. Once that is complete, the 
method is complete and the 
return is executed. 
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BOOL SetTypeEA{ PSZ pszFilePath, PSZ pszEAValue ); 


h 

* SOM generates method stubs that 

* cause compiler warnings. Suspend warnings 

* (but be wary, this can mask errors in the 

* emitted "passthru" sections of the CSC file)* 
*/ 


Idefine MyRewQbject_CLass,Source 
#pragma checkout(suspend) 
iinclude "mynewobj.ih" 
ipragma checkout(resume) 


h 

* 

* OVERRIDE: wpPrintObject 

* 

* DESCRIPTION: 


( ) PRIVATE 
(X) PUBLIC 


* Called to print a view of the object 

* 

* Passed is a pointer to me, along with a structure that can be 

* used to call DevPostDeviceModes or DevOpenDC call to be able to 

* open a printer DC. When called here, I need to call DosExecPgm on 

* my EXE, pass it the name of the file I represent and the print 

* destination, along with a flag to tell it to now show itself, and just 

* print the file on the destination* It is up to the app if it wants to 

* also DevPostDeviceModes to see if the user wants to change any of the 

* job properties from the defaults. (The app should go away after the 

* doc is printed, but that is an app function. The "Best" way to do it 

* is to have an entry point in one of your DLLs so you don't have to 

* invoke the whole app. The entry point could spin off a print thread 

* to be able to return control back to the shell so you don't freeze the 

* shell while the doc prints* 

*/ 


$0M_Scope BQDL S0ML1NK myn_wpPrintQbject(MyNewObject *somSelf, 

PPRINTDEST pPrintDest, 

ULONG ulReserved) 

i 

BOOL bSuccess = TRUE; 

/* MyNewObjectData *somThi$ = MyNewObjectGetData(somSelf); */ 

/■# My NewQbj ectMethodDebugC"MyNewQbj ect", "myn_wpP r intDbj ect 11 ); */ 

/* DosExecPgm on the app after querying to see the name of the file */ 
/* i represent (upQiieryRealName against myself). Pass that plus the flag */ 
/* to the EXE (or call the entry point of the app DLL to print the file) */ 


Figure 2. Sample object's. C file (continued on page 28) 
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> 

h 


return (bSuccess); 


* OVERRIDE: wpSetup 

* 

* DESCRIPTION; 

* 

ALL I need to do here is to 


( ) PRIVATE 
U) PUBLIC 


* 

* 

* 

* 

* 

* 

*/ 


1) Set the object ''type' 1 . This is the type associated with the object. 

2) Modify the setup string to specify my iconfile name. 


S0M_Scope BOOL SOHLINK Fnyn_wpSetup(HyNevObject *sofflSelf, 

PSZ pszSetupString) 

{ 

/* MyNewObjectData *somThis * MyNewObjectGetData(sofiiSelf); */ 

PSZ pszType; 

CHAR szPath[ CCHMAXPATH ]; 

ULONG cb; 

/* HyNewObjectMetliodDebug("HyNeuObject" ) "injn_wpSetup"); */ 
cb = sizeof( szPath }; 

if { parent_wpSetup(somSelf.pszSetupString) 

fii- _wpQueryRealName( somSelf, szPath, ftcb, TRUE ) ) { 
pszType = mynO_wpdsQueryInstanceType(_somGetCLass(somSelf) ); 
if { pszType ) { 

_wpSetType(somSelf, pszType, NULL); 

SetTypeEA( szPath, pszType ); 

> 

return( TRUE ); 

} 

return ( FALSE ); 


( ) PRIVATE 
(A) PUBLIC 


h 

* 

* OVERRIDE: wpCreateAnother 

* 

* DESCRIPTION: 

* 

* Called whenever a new instance of this object class is 

* created when the user selects "Create Another". Note that 

* when the user selects drags one out from a template, 

* we are not called here, but at wpCreateAnother. In here, as well as 


Figure 2. Sample object's . C file (continued on page 29I 
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* in the override to wpCreateFromTerriplate, ye will call PutUpStyleSheetDlg 

* to handle the style sheet work for us. We don't do it here so as not 

* to have the same code in 2 places, 

* 

* Passed to m are a pointer to me, along with the folder in which the 

* user wants to create the object. I'll call my parent class 

* parent_wpCreateAnother to handle the meat of creation, I just want 

* to give the user the choice of style sheet. (Kind of like when you 

* subclass a window in PM.) (Make sure to pass the folder to 

* PutUpStyleSheetDlg if you are going to do the actual data file creation 

* from style sheet work there.) 

* 

*/ 

SOM.Scope WPQbject * SOWLINK myn_«pCreateAnother(MyNewObject *somSelf, 

PSZ pszTitle, 

PSZ pszSetupEnv, 

WPFoider *Folder) 

{ 

/* NyNewObjectOata *somIhis = MyNewObjectGetData(somSelf); */ 

MyNewObject ^Object; 

HyNewObjectNethodDebugf "MyNewObject" ,“myn^wpCreateAnother"); 

Object - pa rent j*pCreateAnothe r(somSelf,pszTitle,pszSetupEn v,Folder); 
if ( Object ) { 

PutUpStyleSheetDlgO; 

> 

return ( Object ); 

> 




* OVERRIDE: wpCreateFromlemplate ( ) PRIVATE 

* (X) PUBLIC 

* DESCRIPTION: 

t 

* Called whenever a new instance of this object class is 

* created when the user drags one out from a template. Note that 

* when the user selects "Create Another*’ from an existing instance, 
we are not called here, but at wpCreateAnother, In here, as well as 

* in the override to wpCreateAnother, we will call PutUpStyleSheetDlg 

* to handle the style sheet work for us. We don't do it here so as not 

* to have the same code in 2 places. 

* 

* Passed to me are a pointer to me, along with the folder in which the 

* user wants to create the object. I'll call my parent class 

* parent.wpCreateFromTemplate to handle the meat of creation, I just want 

* to give the user the choice of style sheet. (Kind of like when you 

* subclass a window in PH) (Hake sure to pass the folder to 


Figure 2. Sample object's. C file (continued on page 30) 
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* if you are going to do the actual data file creation 

* from style sheet york there.) 

* 

*/ 

$QM_Scope HPQbject * SOMLINK myn_wpCreateFronTernplate(WyNeyObject *$omSelf, 
VfFolder ♦folder, 

BOOL fLock) 


{ 


/* MyNeyQbjectData *somThis = MyNewObjectGetDataCsomSelf); */ 
MyNeyObject ♦Object; 

My^^eyObjectHethodDebug( ^l MyNewObject , ^"myn_MpCreateFromTe^nplate ,, ); 

Object * parent_ypCreateFromTemplate(somSelf,folder,fLock); 
if ( Object ) { 

PutUpStyleSheetDlgO ; 

> 

return ( Object ); 


/* 

* 


( ) PRIVATE 
(30 PUBLIC 


* OVERRIDE: wpclsQueryTitle 

♦ 

♦ DESCRIPTION: 

* 

♦ Return the string "My Object Document" as the title of the class 

* 

*/ 

•undef 50M_CurrentCia$s 
•define SOM_Currentdass SOMMeta 

SOMJscope PSZ SOKLINK myn0^pclsQueryTitle(K.HyNeyObject *som$elf) 

/* K MyNeytJbjectData *somThis = H_NyNeyObjectGetData(somSelf}; */ 

N_HyNeyObjectMethodDebug("M_MyNeyObject","mynO_ypclsQueryTitle"); 

return (mynO>pclsl}ueryInstanceType( _somGetQass( somSelf) )); 


/* 


* OVERRIDE: wpclsQuerylnstanceType 

* 

* DESCRIPTION: 

* 

♦ 

* 

* 


( ) PRIVATE 
(X) PUBLIC 


This will set up my file types for associations 
This needs to match exactly the Type used in the 
ASSQCTABLE 


figure Z Sample object's . C fife (continued on page 31) 


30 


OS/2 developer 
















*/ 


SQM.Scope PSZ SOMLINK mynQ_vpclsI)ueryInstanceType(MJlyNewObject *soinSeif) 

{ 

/* M_MyNewGbjectData *somThis = H_MyNewDbjectGetData(somSelf); */ 
MJ^yNeyDbjectMethodDebug( u H_MyNewDbject" /inynO.upeIsQueryInstanceType"); 

return ("My Object Document"); 

} 


/* 

* 

* OVERRIDE: ypclsQuerylnstanceFilter ( ) PRIVATE 

* (X) PUBLIC 

* DESCRIPTION: 

* 

* This will set up the filter for the file types for associations 

* This needs to match exactly the file filter used in the 

* A5S0CTABLE 

* 

*/ 

#undef SOM_CurrentOass 
♦define SOM_Currentdass SOMMeta 

SOM_Scope PSZ SOMLINK mynO_wpclsQueryInstanceFilter(M,MyNewObject *somSelf) 

/* M_HyNewObjectData *somThis = MJfyNewQbjeetGetData(somSelf); */ 
K.MyNetfObjectMethodDebugC'H^MyNewObject" , ,r fnyn0^upclsQueryInstanceFilter"); 

return ("*.NYIT); 

} 

#undef SOM_CurrentCla$$ 

/* 

* Force the ea on the file. This is a work around for a 

* workplace bug. This is only a problem from wpSetup when the 

* object is first created. 

*/ 

8DQL SetTypeEA{ PSZ pszFilePath, PSZ pszEAValue ) 

USHORT cbValue; 

USHORT cbMem; 

USHORT rc; 

PFEA2LIST pfeaZL; 

PSZ ptr, ptrEnd; 

PBYTE ptrValue, ptrCurrent; 


Figure 2 Sample object's . C file (continued on page 32} 
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EA0P2 eaop; 

PSZ pszEAName = ".TYPE"; 

ptr = pszEAValue; 

cbValue = 0; 

if ( ptr M *ptr ) { 

cbValue - strlen{ ptr ); 

> /* end if */ 
if ( cbValue } { 

cbValue += 2 * sizeof ( USHORT ); 

> /* end if */ 

cbHem = (USHORT)sizeof( FEA2LIST ) ♦ strlen{ pszEAName ) + (USHDRT)cbValue; 
pfeaZL =(PFEA2LIST) caHoc( 1, CULON€)cb«em ); 
if ( !pfea21 ) { 
return FUSE; 

> /* end if */ 

memset( CPOOpfeaZL, 0, cbHem); 
pfea21->cbList = cbHem; 

pfea2X~>li$t[G].cbName - (BYTE)strlenC pszEAName ); 
pfea2X->list[0].cbValue = cbValue; 
strcpy( pfea21->Iist[Q],szNaiiie f pszEIName }; 
if ( cbValue ) { 
ptr = pszEAValue; 

ptrValue - 4pfea21->list[0].$zName[ strlen( pszEAName ) + 1 ]; 

(C PUSH 0 RT) ptr Value) [0] = EATJSQI; 

((PUSHQRT) ptr Value) [1] = cbValue - (USHORT)(2 * sizeof(USHORT)) ; 
memcpy( £ptrValue[4], ptr, ((PUSHQRT)ptrValue)[1] ); 

> /* end if */ 

eaop,fpGEA2Li$t = NULL; 
eaop,fpFEA2List = pfea2L; 
eaop.oErrar = 0; 

rc = (USHORT)DosSetPathInfo( pszFilePath, 2L, fteaop, sizeof( eaop ), OL ); 
free( (CHUR OpfeaZL ); 
return (USHORT)Orc); 

> 

/* Private function*. PutUpStyleSheetDlg 
* 

* This function is called in the overrides for both vpCreateAnother and 

* wpCreateFromTemplate. This will put up the dialog that reads the 

* "style sheet directory" for all the style sheets and puts them in 

* a selection dialog for the user to choose from (don't forget to add a 

* "non" option to the listbox,) You can then either copy the style sheet to 

* the new data file here, or do it in the overrides. You should probably 

* do it here to have the code in only one place. 

* 

* When I get to this function, I need to first put up a dialog asking 


Figure 2. Sample object's . C file (continued on page 34) 


32 


OS/2 DEVELOPER 
















MMING & DESIGN • C O M P U T E R W O R L D CLIENT/SERVER JOURNAL • MICROSOFT SYSTEMS JOURNAL • OS/2 DEVELOPER 



• BORLAND • 


Conferences, 

October 3 - 7, 1994 
Exhibition, 

October 4-6, 1994 

Washington Convention Center 
Washington D.C. 



Come See the Software and Application 
Development Industries Come Alive! 

“The best speakers, the best demonstrations, and the best exhibition!” Terry McIntosh, Anaiytt ■ Chevron Corp. 


SD ‘94 East delivers 
development solutions 
across the spectrum of 
tools from C++ to 
Powerbuilder. 

• Clicnt/Server Tools 

• Object-Oriented Tools 

• Rapid Application Development Tools 

• Database Design and Modeling TooLs 

• CASE Tools 

• GUI Front Ends 

• Languages 

• Configuration Management Tools 

• Testing and Debugging Tools 

• Porting Tools 

• Multimedia Tools 


SD ‘94 East provides 
powerful, real-world, 
real-time education 
in 4 jam-packed 
conferences. 

SD was the first and continues to be 
best at bringing you practical unbiased 
guidance in over 200 classes across 
17 tracks. 





■ 2 = 



Join us at SD ‘94 East 
as the industry comes 
alive... 


...on the show floor, in the conference 
sessions and in a series of special events 
with key industry players. 

• 4 Plenary sessions include: 

Mitchell Kertzman, CEO, Powersoft 
Christine Comaford, PC Week 
Vaughan Merlyn, Partner, Ernst & Young 

• Hours of free technical sessions 
by Microsoft, Powersoft, Intersolv 
and others 

• The C++ Programming Superbowl 


Ti$f 


Tools and 
Techniques for 
Software and 
Application 
Developers 


Call for a 

1-800-441-8826 

415-905-2784 

Brochure! 

Internet: sd94east@mfi.com 
FAX: 415-905-2222 


• DR. DOBB S • DBMS • SOFTWARE DEVELOPMENT MAGAZINE • APPLICATION DEVELOPMENT TRENDS 


G E 
































vpCretUFnmTeqdate 

The wpCreateFromTemplate method is 
called when (as the name implies) 
the user creates a new class 
instance by dragging one out from 
a template. Here you need to do 
the same as you did with 
wpCreatelnother. First, the parent 
method is called to actually 
create the instance. And then 
PutUpStyleSheetOialog is called to 
set the style sheet 

Of course, this entire style 
sheet business is optional. I added 
it to show you how you can call 
parent methods to provide the 
function of the parent class, while 
allowing you to override as much 
or as little of a parent method as 
you need (or just to make use of 
the parent's method and add to it 
rather than replace it). 


CLASS METHODS 

Class methods, as opposed to 
instance methods, are responded 
to by the class, rather than by the 
instances of the class. These are 
methods that all instances of this 
specific class obey because the class 
is doing the responding. These are 
the class method overrides for this 
sample object class. These are the 
basic methods almost any object 
you write will need to override. 
You will also notice the lines: 


tundef $OM_CurrentQass 
•define SOM_CurrentCLass SOMMeta 


before each class method. 1 alluded 
to this previously when I men¬ 
tioned the specific lines the SOM 
emitters put before the class meth¬ 
ods that are not around the 
instance methods. Because of these 
lines, do not put instance method 
overrides after the first class 
method override. When you add 
new instance method overrides to 
a .CSC file, the emitters will put the 
code at the end of the .C file. So, if 
you add new instance method 
overrides, be sure to move them 


* the user which style sheet (s)he wants. To do this, I will look at my 

* app defaults and figure out what directory the style sheets are in. 

* I 11 read the file list and give the user a choice of whatever style 

* sheets are in there. This way a user can create his/her own style sheets 
and put them n this directory, and they will become part of AmiPro 

* (nice feature). When the user selects the style sheet, create 

* the physical file with the style sheet selected 

* 

* You should probably pass the folder the new instance is being placed 

* into to this function so you know where to create the datafile. 

*/ 

PutUpStyleSheetDlg{) 


Dos8eep(329,300); 

DosBeep(392,350); 

DosBeep(329,75); 

Dos8eep(349,300); 

DosBeep(392,325); 

return; 

> 


Figure 2* Sample object's . C file (continued from page 32) 


above the first class method over¬ 
ride before you compile. 

ypclsQueryTltlB 

The wpclsQueryTitle method is 
called when an object wants to 
obtain the name or title of your 
class. This method is simple 
because it returns an ASCII string, 
which is the class name. 

I coded the title so it matched 
the instance type. In this way, and 
as you will see in the following 
override, I only needed to return 
the string that is the title ("My 
Document Object") in the override 
for wpclsQuerylnstanceType. Now in 
the override for upclsQueryTitle, the 
title can be returned by invoking 
wpclsQuerylnstanceType on the object 
itself (my nQ_wpclsQueryInstanceType). 

vpclsQuerf Instance Type 

The wpclsQuerylnstanceType method 
is called when an object wants to 


know the type of object this is. As 
explained previously, the type is Ny 
Document Object, which is what is 
being set in the .TYPE extended 
attribute and is the title of 
the class. To respond to a 
wpclsQuerylnstanceType call, you need 
to return only the text string. The 
string must be the same as the title 
field of an ISSQCTABLE entry for the 
executable file. This linkage is how 
the shell links the .EXE and the ob¬ 
ject in its internal tables. 

vpclsQverylnstanceFlLter 

The vpclsQuerylnstanceFilter meth¬ 
od is invoked when an object 
wants to know the file system fil¬ 
ter for the file types for this type 
of object. This method, like the 
previous method override, helps 
the Shell map the executable file 
to the Shell's representation of the 
data file (object). In this case, the 
mapping is for the file name 
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extension or filter. 

In the ASSOCTABLE statement in 
the resource file for the executable 
program, you specify not only the 
type name but also a file name 
extension or set of file name exten¬ 
sions. In the override for 
wpdsQuerylnstanceFilter, you return 
the text string that is the file name 
extension filter (in this case, *.MYN). 

PRIVATE FUNCTIONS 

The private functions are only 
callable by the method overrides 
for this class. These are internal 
functions of the DLL; they will be 
specific to your class and cannot be 
called by anyone but you. 

S*tTyp*Ei 

This function sets the .TYPE ex¬ 
tended attribute for the file name 
passed to it. 

PrtUftityl$Sh*eting 

Although this function does noth¬ 
ing but play a tune, its purpose is 
to perform the initialization you 
want during the initialization of a 
new instance of the object class. 

TYING IT TOGETHER 

Some of what I have covered in 
this column may not seem imme¬ 
diately obvious. You will under¬ 
stand it gradually as you work 
with Workplace Shell code. 

When you look at this object 
as an entity, first notice that any 


object entity has several interfaces 
to the Shell. For example, you can 
"link" applications to objects 
using several mechanisms. The 
first is the ASSOCTABLE in the exe¬ 
cutable. When the executable pro¬ 
gram is first awakened by the 
Shell, the ASSOCTABLE is read and 
associations are built. These asso¬ 
ciations hook the executable pro¬ 
gram with a file extension or filter 
and a type. 

These items (the filter and 
type) are two of the class methods 
that are overridden. The values 
returned in these overrides must 
match the values you place in the 
ASSOCTABLE. In this way, the Shell can 
access the object and invoke the 
executable no matter how the user 
accesses it (from the program 
object, from the document object, 
and so on). 

Also notice that there is no 
explicit code for the icon handling 
for the object class. If you use an 
ASSOCTABLE statement and specify 
an icon, the Shell will automati¬ 
cally pick up the icon from that; 
you do not need specific code in 
the object class definition for cus¬ 
tom icons. 

By using the small set of over¬ 
rides in wpSetup, wpdsQuerylnstanceType, 
wpdsQuerylnstanceFilter, and wpds- 
QueryTitle, along with an ASSOCTABLE 
in the executable, you can provide 
the fundamental functions of a 
Workplace Shell object. 


NOW ITS UP TO YOU 

Once you have completed these 
functions, you can customize the 
class's behaviors with overrides, 
such as wpPrintObject and others. 

Carefully examine everything 
you do in your object class, be¬ 
cause the shell-defined classes are 
powerful and versatile. You will be 
tempted to concentrate on over¬ 
rides, but carefully examine the 
already-defined methods. There 
may be some function you can use 
rather than rewrite. Whenever pos¬ 
sible, use the class's code rather 
than write it yourself. Refer to the 
example in wpCreateFromTemplate; 
notice that it calls the parent 
method to create the instance, 
then, before returning to the caller, 
performs the customization work. 
This concept can save you a lot of 
time and money. 

Use the sample object as a 
skeleton. If you combine it with 
the MAKE file from the my last col¬ 
umn, you'll be all set to write 
Workplace Shells objects. 



David Reich has been with the IBM OS/2 
development team since 1987. He has 
worked on many parts of the system, sup¬ 
ported customers and application develop¬ 
ers, and traveled the world giving seminars 
and teaching OS/2. He is the author of 
Designing OS/2 Applications, published by 
John Wiley and Sons. He can be reached on 
CompuServe at 76711,632 or via the Internet 
at speedracer@vnet.ibm.com. 
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Object-Oriented Programming 

The emerging OpenDoc technology promises a cross-platform, language-independent, LAN-supporting 
standard for the exchange of compound documents among a variety of applications. We'll have more to 
say about OpenDoc and other OS/2 object programming topics in our September/October issue. For now, 
here's an introduction to get you started. By ROBERTL. TYCAST 


Component Software for the 
Masses: OpenDoc is Here 


S everal years ago, the electronics 
industry was producing console 
stereos. These units were sold 
more like furniture than electronic 
devices. One large cabinet came com¬ 
plete with television, record player, 
speakers, and AM/FM radio. 

Consumer choices were limited. If 
you didn't like the speakers, you had to 
live with them or buy a different model, 
but then maybe the record player 
wouldn't be up to your standards. There 
was no way to mix and match the pieces 
of a system to match your needs, tastes, 
or budget. And if that wasn't bad 
enough, when new technology arrived, 
you couldn't just add it to the box. You 
had to scrap what you had and buy a 
complete new package. 

Today's consumers would never tol¬ 
erate that. They are accustomed to pick¬ 
ing and choosing their compact disc 
players, speakers, tuners, VCRs, and 
video monitors to build their personal 
home entertainment systems. Shoppers 
have complete freedom to choose from a 
large number of products produced by 
different manufacturers using an ever¬ 
growing number of new technologies. 
They need not worry that their home 
system will be instantly obsolete 
because of a new product they might 
want to buy next year. They are safe in 


assuming that the producers of con¬ 
sumer electronics will make sure that 
next year's products will plug into the 
home system purchased today. 

This is ideal for both producers and 
consumers. Consumers have more flexi¬ 
bility and choices, and producers have a 
bigger market in which to sell their tech¬ 
nology. Upgrades to existing systems 
are easy, so a modest advance in tech¬ 
nology can be parlayed into a successful 
moneymaker. New components can be 
marketed aggressively since consumers 
no longer wait until their console sys¬ 
tems '"smoke" themselves into oblivion, 
requiring the consumers to throw them 
away and buy new ones. 

Today's software industry is in 
many ways comparable to the electron¬ 
ics industry of yesteryear. 

Applications are monolithic, contain¬ 
ing every possible function users might 
need (whether or not they really want 
them), locking them into a fixed way of 
working. New software technology 
requires upgrades or replacements. 
Finding a cooperative set of applications 
means buying into a suite of products, 
usually from a single vendor. There is no 
way to mix and match applications, no 
way to add new technology to an existing 
suite without a major update, and no easy 
way for die user to build a custom system. 
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The change in home electronics 
from console to component systems was 
revolutionary. The coming changes in 
the software industry ushering in com¬ 
ponent software will be no less so. And 
the first step in that revolution is called 
OpenDoc. 

OPEN SYSTEMS, OPEN STANDARDS 

OpenDoc is a collection of technologies 
donated to the industry by Apple, IBM, 
and WordPerfect, enabling the building 
of compound documents that can be 
exchanged, viewed, and edited between 
multiple platforms. 

Apple contributed the basic com¬ 
pound document technology of 
OpenDoc, Apple also created Bento, a 
technology that addresses the problems 
inherent in storing compound docu¬ 
ments, and Open Scripting Architecture 
(OSA), which makes interoperability 
between documents and parts of docu¬ 
ments a breeze. 

IBM donated its System Object 
Model (SOM) technology, which is a 
Common Object Request Broker Ar¬ 
chitecture (CORBA) compliant technol¬ 
ogy, enabling documents to be built as 
objects and distributed across a network* 
Finally WordPerfect is contributing tech¬ 
nology that will enable OpenDoc docu¬ 
ments to work with Microsoft's OLE2 
servers and containers. 

The technologies will be owned and 
distributed by a consortium. Com¬ 
ponent Integration Laboratories 
(CILabs)* Modeled after the X Window 
System Consortium, CILabs will distrib¬ 
ute the OpenDoc technologies, promote 
industry standards, and provide certifi¬ 
cation of OpenDoc compliance for soft¬ 
ware products, ensuring that shrink- 
wrapped packages work together from 
the start. 

In addition, Apple is providing a 
reference implementation of OpenDoc 
on its Macintosh platform. WordPerfect 


is creating one for MS-Windows, and 
IBM is writing OpenDoc implementa¬ 
tions for AIX and OS/2. 

PARTS AND PART HANDLERS 

Key to the compound document archi¬ 
tecture is the concept of a part* Parts are 
the individual components used to cre¬ 
ate a document. The most common one 
is the text part. It provides the ability to 
embed and edit text into a document. 
Other part-types may include graphical 
drawing parts; spreadsheet parts; multi¬ 
media parts, such as video and audio; 
spell-check parts; and so on* The list 
goes on and on because the OpenDoc 
architecture is designed to support all 
types of data—even data types not 
invented yet! 

How is this done? The basic pro¬ 
gramming unit is the part handler, and 
every supported data type has one. 
One nice thing about part handlers is 
that they need only concern them¬ 
selves with the bit of functionality that 
they provide. Developers of today's 
monolithic applications must deal with 
every aspect of functionality provided. 
OpenDoc part writers, on the other 
hand, can concentrate on the area of 
specialty their part provides, uncon¬ 
cerned about other ancillary functions 
that users might want* After all, if 
users want to add other functions to 
the application later, they only have to 
add some part handlers* 

STORING THE DOCUMENT 

Once users have assembled documents 
with a diverse set of parts, they will 
want to store and exchange them with 
other users* Handling a document made 
up of multiple parts and data types 
would he less than trivial if it were not 
for OpenDoc's Bento technology. 

Bento is designed to provide storage 
containers for multiple data types in an 
efficient and flexible way* As a docu- 
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ment is modified, Bento creates 
new drafts. This archiving of the 
document is very storage-efficient, 
since only the changes from the 
previous draft are stored. 

The Bento system provides an 
easy way to create links to other 
parts of a document or even out¬ 
side of the document You can cre¬ 
ate a piece of a document once and 
link it to any number of other doc¬ 
uments, even when they are on 
diverse network nodes and plat¬ 
forms. This is important since 
today's and tomorrow's comput¬ 
ing environments are distributed, 
and the networks on which parts 
and documents will be found will 
most certainly be heterogeneous. 


SCRIPTING, EVENTS ■ 

AND RECORDABILITY 

Scripting, events, and record abil¬ 
ity are all features supported by 
OSA-compliant parts. OSA 
defines the way in which docu¬ 
ments and parts communicate 
with each other, and OSA pro¬ 
vides a standard for part handlers 
that guarantees interoperability. 
This standard is called the event 
registry. It contains lists of com¬ 
mand verbs that applications use 
and the objects on which they 
operate. 

The registry gives precise def¬ 
initions on how to encode the 
verbs and objects. The verbs are 
further organized into suites 
according to the type of applica¬ 
tions that typically use them. 

Some examples of the standard 
suites are: 

* Required: the base set of fum> 
tions that ail compliant parts 
will need to support 

* Core: defines file and edit func¬ 
tions and basic scripting 

* Text: defines basic text editing 
and formatting 

* Table: defines commands used 
for table editing and formatting. 

Once OSA support has been 
incorporated into a part, seript- 



• Provides ability to store 
diverse elements (datatypes) 
in one container 

• New datatypes can be 
added at any time 

• Highly portable 
implementation 

• Based on structured 

hierarchy: containers, 
objects, properties, 
value/types Bento: n. [Japanese] 1A box lunch or 

picnic lunch. 2. A box or basket with 
multiple compartments, containing a 
collection of disparate elements arranged 
in an aesthetically pleasing manner. 



Figure f. OpenDoc storage 


ability, recordability, alternate 
input, and other features become 
a reality. To get a sense of the 
power of OSA, here's an example 
of how a typical OSA scripting 
component might read: 

tell application "Hy editor 11 
select word 1 of paragraph 2 


cut selection 
end tell 

The OSA script closely resem¬ 
bles natural language. In fact, 
OSA makes it possible to create 
language-independent scripting 
components. Since the underlying 
mechanism is via OpenEvcnts and 



Figure 2. OpenDoc for OS/2 is on its way 
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IBM OS/2 and other IBM products are trademarks or registered trademarks of International 
Business Machines Corporate. Other product names are trademarks or registered 
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Circle Reader Service Number 12 


ColoradOS/2. The definitive conference for 
OS/2 developers, in the shadow of Pikes Peak. 

Those who attend will get in on the very first 
in-depth analysis, discussion and demonstration 
of exciting new technologies like OpenDoc, 
Workplace OS and the first new object-oriented 
products from the Taligent Frameworks 
partnership. Plus the latest on SOM/DSOM 
and WPS. 

Those who attend will learn about object- 
oriented design directly from Grady Booth, the 
man who wrote the book on it 

Those who attend will hear about the 
REXX language directly from its creator, IBM 
Fellow Mike Cowlishaw. They’ll get the inside 
story directly from IBM Director of Object 
Technology Products Cliff Reeves. And they’ll 
talk in-depth about internationalization 
and DBCS. 

And those who don’t, won’t 

ColoradOS/2 Miss it, and you’ll miss a lot 
Make it, and you’ve got it made. 

Plan now to attend ColoradOS/Z 
For reservations, call the Cheyenne Mountain 
Conference Resort at (800) 648-5717 or 
(719) 576-5003. For more information, call 
(800) 481-3389 or (719) 481-3389. 


After November 4,1994, there will 
be two kinds of OS/2 developers. 
Those who went to ColoradOS/2. 

And those who didn’t. 

CoioradOS/2 
October 30-\ovember 4,1994 
Cheyenne Mountain Conference Resort, 
Colorado Springs, CO 















object specifiers/ a script editor 
could translate the preceding 
script to: 


utilise 1"application ,r My editor 1 ' 
selections mot 1 du pa rag raphe 2 
coupe selection 
fin de utilise 


with the simple click on a 
"Frangais" radio button, (This 
example uses a format typical of 
the AppleScript language). 

Since applications can respond 
to OSAEventS/ it's easy to monitor 
event traffic and record it for later 
playback. Another advantage of 
factoring a part to be driven by 
OSAEvents is that any compo¬ 
nent—the user interface, the script 
language, voice or pen input'—can 
generate an OS A Event and drive 
the application. 

BRINGING IT ALL TOGETHER- 
SYSTEM OBJECT MODEL 

The SOM technology contributed 
by IBM sets the foundation for 
OpenDoc firmly on new object 
technology* SOM provides a 
CORBA-compliant way for parts to 
create objects that are platform- and 
language-independent and that can 
work in a distributed environment. 
This object "glue" is an essential 
ingredient to the CILabs strategy of 


supplying industry-standard object 
technology 

The changeover to component 
software will be as profound a 
shift for users and software pro¬ 
ducers as the shift to third-gener¬ 
ation languages like FORTRAN, 
C, and PASCAL was in its day. A 
key part of IBM's overall strategy 
is to exploit its software technol¬ 
ogy. OpenDoc builds on the lead 
that SOM represented in the 
objects world. It is an important 
step to taking OS/2 to new levels 
of functionality and flexibility. 

WHERE TO FIND OUT MORE 

This article has only touched the 
surface of OpenDoc technologies. 
Subsequent articles will go into 
more depth about how the archi¬ 
tecture fits together and how 


developers actually write part han¬ 
dlers, Look for this series to con¬ 
tinue in the September/October 
1994 issue of OS/2 Developer, 

Robert L. Tycast, IBM Entry Systems 
Division, Boca Raton, Fla., is an advisory 
programmer for the Advanced Pre¬ 
sentation Manager Development group . 
He joined IBM Corp. in 1989 from 
Digital Equipment Corp., where he 
served in a number of software develop¬ 
ment roles, including providing software 
support in the U.S., Latin America, and 
Europe. His project experience over the 
last 13 years includes XI h At 
Technology (LISP and OPS 5 support I, 
and technical workstations (VMS and 
ULTRIXj. Tycast has a B.S. from 
Massachusetts Institute of Technology 
and has done graduate work in MIT's 
computer science department 


REFERENCES 

In the meantime, you can contact CILabs directly for additional (pie 
liminary) information about OpenDoc: 

Component Integration Laboratories 
688 Fourth Ave. 

San Francisco, CA 94118 
(415) 750-8352 (voice) 

(415) 757-4829 (fax) 

Internet: jed@dl.org 
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OnCmd/xBasefor OS/2... 
A Winning Combination! 

OnCmd harnesses the power and the speed of OS/2, enabling you to develop new applications or 
convert existing xBase applications, such as those developed in FoxPro®, Clipper®, and dBase 8 . 


Preserving Your xBase Investment 
OnCmd can quickly convert your xBase applications to run directly in 
OS/Zs 32 bit Presentation Manager with few modifications. This 
eliminates development time and preserves your current xBase 
investment. Text applications are automatically converted to a 
native Presentation Manager application that is 
both multi-user and network capable 
With simple code changes, you can add 
buttons, check boxes, and drop-down 
menus to give your application more 
functionality. 


i 


for OS/2 


for IBM LAN 


Applications Development 
OnCmd's user-friendly develop¬ 
ment environment makes devel¬ 
oping new applications 
easy and efficient The 
OnCmd screen painter 
brings point and click sim¬ 
plicity to screen designs, 
allowing you to develop the layouts you need, 
while preserving your control over application 
flow. Support for “event-driven" programming and 
the use of extensible Dynamic Link Libraries (DLL) offers even 
greater power to your database 

Client/Server Ready 

OnCmd allows you to create a client server environment without the 
need for a dedicated server system. You can evolve into the world of 
client/server at your own speed and at a very low cost, allowing you to 
take advantage of the improved performance and application 
stability of client/server. 


Multi-User Networking 

OnCmd automatically enforces multi-user database integrity through 
the network with no code changes. File and record 

locking can be added to your application if higher 
level transaction integrity is required. You can 
add message passing to create co-operative 
or client/server relationships in your 
applications, Including direct messaging to your 
“C“ programs. 

A Performance Winner 
OnCmd is a performance winner! No windows 
emulation overhead. Disk requirements less 
than 1MB, Installation under 5 minutes. In 
addition, it typically indexes large databases 
twice as fast as the competition in half the 
disk space. For more benchmark details, 
call or email us. 

Go for the gold. 

Order your copy today! 


ON-LINE DATA 
5 Hill Street, P.O. Box 65 
Kitchener, Ontario Canada N2G 3X4 
Tel: (5191 579-3930 Fax: (519) 579-2130 
CompuServe: 70022,104 
Internet oncmd@onlinedats.com 
* Prices are in US funds. 

Add $249 per 10 user blocks (Regular $498), 
Offer expires August 30/94. 
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mSWA Pen Systems 


In this article, we'll show you how to use the pen as an input device, and even make it talk back to youi 

By VERA DULANEY and KEVIN LEE 


The Talking Pen: Coding a 
Pen/Audio Application 


apoleon once said, 'The pen is 
mightier than the sword," but 
we Pen for OS/2 developers pre¬ 
fer, "The pen is mightier than the mouse/' 
The pen gives the user a much more intu¬ 
itive pointing device than the mouse. The 
pen also gives more information about its 
movement than the mouse can. 

PEN VS. MOUSE 

When you move a mouse, OS/2's 
Presentation Manager handles the posi¬ 
tion of the pointer and knows when the 
mouse button is pressed or released, but 
any activity between the start and end 
points is ignored. Pen for OS/2, on the 
other hand, follows the pen's movement 
across a touch-sensitive screen or digi¬ 
tizer and keeps all the point locations in 
a buffer. The collection of points 
between the position where the pen first 
touches the surface and the position 
where it is lifted up is called a stroke. 

INKING 

Pen for OS/2 provides messages and 
functions for a user application to 
process pen movement and produce the 
ink, which is the visible trail of the pen 
moving across the screen. Users can do 
their own inking of pen movement if 
they want a specific color or width of 
the ink or let Pen for OS/2 ink in the 


default color. Also, users can collect and 
manage pen movement or let Pen for 
OS/2 build a stroke buffer that stores all 
pen positions. When the buffer is built 
by Pen for OS/2, it is built in real time, 
and users are notified of its availability. 
If users want their own format of stroke 
buffer or do not need the data in the 
stroke buffer, the buffer is not built by 
Pen for OS/2. 

UNLIKE THE SPACE SHUTTLE ; 

TOUCHDOWN COMES BEFORE LIFTOFF! 

There are four messages used to process 
a stroke: 

WH_T0UCHD0WN Makes contact with surface 

WLUFTQFF Breaks contact with surface 

UHJUISEMYE Moves pen 

WH_SENSOR,MDVE Moves pen. 

All pointing device messages are sent to 
the application; Pen for OS/2 treats pen 
messages as mouse messages. The 
WM_TOUCHDQWN message is sent first to the 
window under the point of contact. There 
are three types of return codes: the delay 
between the touch-down point and the 
mouse-button-down event message, an 
option to override the default inking's 
color and width, and options to receive 
coordinate data at full bandwidth, which 
sets the hardware sampling rate. 
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The application must call 
WinSetCapture function while the WM_TQUCH- 
DOWN message is being processed. There 
are several ways to handle inking and 
the stroke buffer, described in the Pen for 
OS/2 Programming Guide . 

Pen movement messages are sent to 
the application while the pen is in con¬ 
tact with the surface. Depending on the 
return code of yfl_TOUCHDQyfll, the WH_SEN" 
SDR.HOVE or WM^HOUSEHOVE message will be 
sent. The application can ink the stroke 
or perform other operations, such as 
erasing, as the messages are received at 
different surface locations. 

The yM_LIFTQFF message is sent to the 
application at the end of the stroke. Call 
WinSetCapture with NULLHANDLE to release the 
pointing device message capture. If 
T0N_N0_STR0KE is returned to the ytt.TQUCHDOyN 
message, the application can access the 
stroke buffer through the yrtQueryStrokeOata 
function. To retrieve the data, the applica¬ 
tion must first query the size of die buffer 
to allocate sufficient memory to store it. 
Stroke data can be provided in either 
screen coordinate or window coordinate 
format. The application can replay 
retrieved stroke data later on the screen. 

If TDN_INfIKnE_PAUSE is returned to the 
yftTOUCHDOWN message, Pen for OS/2 does 
the inking of the stroke and provides a 
stroke buffer. As points are entered into the 
stroke buffer, they are connected to the 
previous points and displayed on the 
screen to give the appearance of ink flow¬ 
ing from the point of the pointing device. 
The inking is done in such a way as to not 
interfere with the underlying graphical 
data. At the end of the stroke, the WHJJFTOFF 
message will be sent to the application and 
a stroke buffer is available. The de-inking 
of the stroke will be done upon return 
from the yw, LIFTOFF message. 

Due to the high rate of movement 
messages determined by the hardware 
sample rate, each message must be 
processed in a short period of time. If 


the application falls behind, it will still 
receive all the messages, but the process¬ 
ing of the points will appear slow com¬ 
pared to the pen movement. 

Pen for OS/2 currently limits the size 
of the stroke buffer to 1,000 points or 10 
seconds of activity, it checks each stroke; 
if it recognizes one as a predefined ges¬ 
ture, it executes an appropriate com¬ 
mand, But the stroke can be used in other 
ways, such as signature verification. Pen 
for OS/2 records not only the signature 
but also the relative speed of writing each 
letter in the name and even the timing of 
dotting the Is and crossing the Ts. 

Our example combines the use of pen 
and multimedia to save a pen stroke and 
audio response in a Presentation Manager 
window. We used the audio recording and 
playback feature of MMPM/2, the IBM 
multimedia system. This sample program 
(HHINK) is available in the current Pen for 
OS/2 Toolkit, on the Developer Con¬ 
nection CD-ROM. The voice attachment 
dialog box provides buttons to start 
recording, stop recording, and play back 
the recorded audio. While the program is 
recording the audio, it saves the stroke 
data through the WH_STR0KE message. The 
key point is to store the stroke and audio 
data with an internal timer so they can be 
played back synchronously. 

This is an example of an application 
that could use the synchronous annota¬ 
tion of voice and ink data on a document. 
Suppose an office manager is reading a 
document displayed as a bitmap in a 
Presentation Manager window and wants 
to modify the document The manager 
can use a pen to circle an area to modify 
and record voice instructions at the same 
time. Later, the secretary can replay the 
ink and audio annotation on the docu¬ 
ment and modify it. If the manager's and 
secretary's computers are connected by a 
network, all document, stroke, and voice 
data can be sent between them directly by 
electronic mail. 
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MRESULT EXPENTRY InkWinProc(HWND hWnd, ULONG msg, MPARAH mpl, MPARAM mp2) 


{ 

HWND hwnd; /♦ My window handle ♦/ 

HPS hps; /♦ Handle to presentation space ♦/ 

POINTL points; /♦ Point structure for saving last point ♦/ 

SIZEL OrgWindowSize; /♦ Size of window at time of stroke input ♦/ 

LONG CurrentColor; /♦ Current ink color ♦/ 

LONG NumSegments; /♦ Number of graphic segments in PS ♦/ 


ULONG buflen; 

PSTROKEDATA pStrokeData; 

APIRET rc; 

static USHORT PointCounter = 0; 

static POINTL pPointU8e; 

static BOOL StrokeBufferOverrun = FALSE; 

RECTL rd; 

WRTEVENTDATA EventData; 
switch(msg) 

{ 

/**♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦ 

* Assume the initial setup is done, for example, creation of the * 

* presentation space. * 

************♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦***♦♦*♦♦♦♦♦♦♦**♦♦****♦*♦/ 

case WM.TOUCHDOWN: /♦♦♦♦♦*♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦*♦♦♦♦♦♦♦♦♦♦♦♦*♦♦♦♦*♦♦♦**♦*♦♦♦♦♦♦*♦♦♦***♦***** 

* Capture mouse messages, move to the point where the pen touches * 

* the workpad to ink. * 

^♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦*********************/ { 

GpiOpenSegment(hps, ♦♦NumSegments ); 

WinQueryWindowRect(hWnd, fcrcl); OrgWindowSize.cx = rcl.xRight; OrgWindowSize.cy = rcl.yTop; 
PointCounter = 0; 

WinSetCapture ( HWND.OESKTOP, hWnd ); 
/♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦I******* 5 ******************* 

♦ Note that the (SHORT) cast is required in order to maintain ♦ 

* sign. * 

sMM************************************************************** 

/ points.x = (SHORT) SH0RT1FR0MMP ( mpl ); 

points.y = (SHORT) SH0RT2FR0MMP ( mpl ); 

GpiMove (hps, Apoints ); 

/***************************♦*********♦****♦*********************** 

* TON.INFINTE: Inform Pen for OS/2 that the mouse button down * 

♦is not required. ♦ 

♦ TDN.HIFREQ.MOUSEMOYE: Inform Pen for OS/2 to report the points ♦ 

♦as mousemoves but at the sensor sample rate. ♦ 

♦ TDN.NO.INK.STROKE: Inform Pen for OS/2 not to ink the points ♦ 

* since we will be doing our inking. ♦ 
**♦♦♦♦*♦***********♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦**♦♦*♦*♦**************** 

/ return ( (MRESULT) ( TON.INFINITE ] 

TON.HIFREQ.MOUSEMOVE ] 

TDN.NO.INK.STROkI )); 

break; 

> 

case WM.MOUSEMOVE: 

/^t***************************************************************** 

* For this message, the inking is done to show the stroke. * 
*♦»*****»»*********************************************************/ 


Figure 1. Sample program for handling pen strokes (continued on page 461 
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The future of Business Ccjrajjuting 

is Here Todays 


Introducing 








WORK FASTER - PenOirect for OS/2 is very fast Click, point, 
drag and draw with greater speed and precision than you can 
get from any other pointing device, plus a light pen won't fight 
with you for desk space. And with PenDirect's easy-to-install hard¬ 
ware (ISA, MCA or optional external) and solid award-winning 
software, you'll be up and running in just minutes. 


WORK SMARTER —PenDirect works great with all of your 
OS/2 software. Enhance graphics programs and bring desk¬ 
top conferencing to life. Effortlessly navigate large spread¬ 
sheets, and get real light pen support for your 3270 apps. 
PenDirect fully supports all OS/2 2.x, Windows and DOS apps 
— at any screen resolution. Everything you need is included, 
no special monitor is required, and PenDirect lets you con¬ 
tinue to use your mouse. 


WORK MORE PRODUCTIVELY — Direct on-screen input 
means quicker and easier interaction with your computer. 
PenDirect is the most advanced light pen solution available 
today for OS/2. 


-• - 

W. If™ »»__ 


WORK IN COMFORT — PenDirect's one-to-one cursor interac¬ 
tion means long-term computer use that's simple and effortless. 
The pen’s precise and 
quick input maximizes 
cursor control to elimi¬ 
nate "mouse dyslexia." 

You’ll find your natural 
hand/eye coordination 
beats fumbling with an 
awkward mouse any 
day. Light pens also 
eliminate the tedious 
wrist movements asso¬ 
ciated with mice that 
cause fatigue and re¬ 
petitive strain injuries. 


2LJlgi=EM?im 
Sales Figures _ 

SoJUo 

QAJL 

OfU 


ONLY 


Bang pen computing functionality to desktop 
conferencing software, like IBM's Person to Person, 


,^TK>N 




WORK SAFER —PenDirectforOS/2 comes from FTG 
Data Systems, recognized as the world leader in 
light pen technology for PCs. FTG sells reliable 
American-made products backed with the 
best warranty in the industry, outstanding toll- 
free customer support and an unconditional 
no-risk, no-hassle evaluation/return policy. 
With over 100,000 pens installed, FTG is your 
safe choice and your best choice. 


limited-time introductory offer 
(regularly S398) 

For a free 30-day evaluation unit, 
or more information, call: 

800 % jo t 


714-995-3900 • FAX 714-995-3989 


FTC 


DATA 

SYSTEMS 


8381 Katella Avenue 
Stanton, California 90680 


Firr! 

p 1994 FTG Data Systems, All rights reserved. Screen shot courtesy of 


PenDirect is a trademark of FTG Data Systems. OS/2 is a trademark of International Business Machine: 

- All other trademarks asa iirnperry nf ihnir rnrfinrfiun murmn 
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{ 

/**♦♦*♦**♦♦******♦**♦♦*♦*♦****♦*♦*♦****♦*****♦♦♦*****♦♦****♦**♦* 

* This release of Pen for OS/2 has a maximum limit to the size * 

* of the stroke buffer. It is limited to 1024 points or eight * 

* seconds per stroke. If the maximum size of the stroke buffer * 

* is reached, then inform the user via a tone. * 
***************************************************************/ 
if ( StrokeBufferOverrun ) 

{ 

DosBeep ( 4000, 16 ); 
return ( (MRESULT) TRUE ); 

}; 

/*************************************************************** 

* Get the event data to see if the stroke buffer has been * 

* been filled. * 

**♦♦♦♦♦♦*♦**♦*♦♦#*♦♦♦*♦***♦**♦♦*♦***♦♦*♦♦♦*♦**♦♦**♦♦♦***♦♦*♦*♦*/ 
EventData.cbStructSize = sizeof(EventData); 

VrtQueryEventData ( fcEventData ); 

if ( EventData.flEventStatus & WRT_BUFFER_OVERRUN ) 

{ 

DosBeep ( 4000, 16 ); 

/********♦♦***♦**#♦*********#******♦♦*♦*♦********♦**♦***♦♦*** 

* Force the inking for all of the remaining points. * 
****************♦***********♦***********************♦*******/ 

GpiBeginPath(hps, 1); 

GpiPolyLine(hps, PointCounter, pPoint); 

GpiEndPath(hps); 

GpiStrokePath(hps, 1, 0); 

GpiQoseSegment(hps); 

StrokeBufferOverrun = TRUE; return ( (MRESULT) TRUE ); 

>; 

/*************************************************************** 

* Keep the (x,y) coordinate in a buffer of 8 entries. * 

* Note that the (SHORT) cast is required in order to maintain * 

* sign. ♦ 

I****************************************************** 5 ********/ 

pPointUPointCountere.x = (SHORT) SH0RT1FR0MMP( mpl ); pPointUPointCountere.y 
PointCounter++; 

if (PointCounter ~ 8) 

{ 

GpiBeginPath(hps, 1); 

GpiPolyLine(hps, 8L, pPoint); 

GpiEndPath(hps); 

GpiStrokePath(hps, 1,0); 

PointCounter = 0; 

} 

return ( (MRESULT) TRUE ); 
break; 

> 

case WM.LIFTOFF: 

/*************************************************************♦******* 

* Stroke ends. Collect stroke end time, No more mouse message * 

* capture, Get the stroke data. * 

*********************************************************************/ t 
WinSetCapture ( HWND.DESKTOP, NULLHANOLE ); 







(SHORT) SH0RT2FR0MMP( mpl ); 


Figure 1. Sample program for handling pen strokes (continued on page 47) 
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/4*****M***********t********************************************** 

* If the buffer was overrun, then the points have already been * 

* displayed, * 

******************************************************************/ 
if ( !StrokeBufferOverrun ) 

{ 

/********:M**********4***********4****************************** 

* Force the inking for all of the remaining points, * 

* Note that the (SHORT) cast is required in order to maintain * 

* sign. * 

***************************************************************/ 

pPointUPointCountere .i * (SHORT) SHORT1FROMHPC mpl ); pPointUPointCountere.y = (SHORT) SH0RT2FR0HMP( mpl ); 
PointCounter++; 

GpiBeginPathChps, 1); 

GpiPolyLine(hps, PoinfCounter, pPoint); 

GpiEndPath(hps); 

Gpi5trokePath{hps, l p O); 

CpiQoseSegment(hps); 

>; 

/********* ************ *****4***4*t*444*44*M#***4*»**!|*+!Mf^4#*4*** 

* Get the size of the stroke buffer, * 

Figure f. Sample program for handling pen strokes (continued on page 48} 



OS/2 DEVELOPER BACK ISSUES 


LIMITED NUMBER OF ISSUES AVAILABLE 

The following Back issues of OS/2 DEVELOPER are available 
for $9.9S each. (Add $2.50 for shipping) 

YES, PLEASE SEND ME: 

□ Winter 1990, DOS to OS/2 Conversion 

□ Fall 1990, Multimedia & Graphics 

□ Fall 1991, Computer Integrated Manufacturing 

■ Winter 1992 SOLD OUT 

□ Spring 1992, 32-bit Tools 

■ Summer 1992 SOLD OUT 

■ Fall 1992 SOLD OUT 

□ Winter 1993, Migration Strategies 

■ Spring 1993 SOLD OUT 

□ July/August 1993, Taligent Spotlight 

□ Sept/Oct 1993, Networking with OS/2 

□ Nov/Dec 1993, SOM/DSOM 

Subscribe to OS/2 DEVELOPER for one year and save 
33% off the cover price. 

YES, PLEASE SEND ME: 

□ 1 year (six issues) - $39.95 in the U,S. 

Canada, Mexico, and international surface mail—add $16 per 
year international air mail—add $30 per year 


Please check the appropriate boxes on this page and 
complete the form below, and mail this page to: 

OS/2 DEVELOPER 

P.O. Box 1079 

Skokie, 1L 60076-9772 

or fax: 708-647-0537 

phone: 800-926-8672 (800-WANT-OS2) 

Please Print: 

NAME ” --—- 

TITLE ---- 

COMPANY ---- 

ADDRESS “ ------ 


□ Check enclosed 

□ Charge my credit card: Q Visa 

□ Mastercard 

□ American Express 

CARD NUMBER “ 1 - — 

EXPIRATION DATE - 

SIGNATURE --- 
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buflen = 0; 


pStrokeData - NULL; 

rc = WrtQueryStrokeData((PBYTE) pStrokeData, ftbuflen, hWnd, OSD SCALE 000)* 
if (rc ]] Ibuflen) " * 

return (HRESULT) TRUE; 

/t************************** ************************************** 

* Allocate memory for the stroke buffer. * 

pStrokeData = (PSTROKEDATA) maHoc(buflen); 
if ( !pStrokeData ) 

{ 

return ( (HRESULT) TRUE ); 

} t 

* Get the stroke data * 

*******************tt****.******t*^Ht***:***********^t********/ 

pStrokeData->cbStructSize = sizeof ( STROKEDATA ); 
if ( WrtQueryStrokeData ( (PBYTE) pStrokeData, 

Figure 1. Sample program for handling pen strokes (continued on page 49) 


MMIMC.EXE 


Annotate 




yF'eri forj^ J^nables you to work with your 
programs using a pen as your primary input 
device. 



ofefc. 


The purpose of tms tutorial Is t® 
familiarize uflu with the basics of Pen for 
OS/2, ^afrfiwrtffln and interaction are 
provided to help you along ihc wag. 


To conti nue, tap on the Fq 
button once. 


~ i ° if 


^ | Voice Attachment 


Duration: 23 Elapsed: 0 


PLAY REG 


STOP 


Volume: 100 






i - : 

!i: a:L* di 



Figure 2. Sample screen with corrections made by both ink data and voice annotation 


Figure 2 is an example of of 
what it would look like if the man¬ 
ager wanted to remove the Pen for 
OS/2 icon, change "Animation" to 
"Annotation/' and change the bold 
font of Forward to italic. 

As shown, the pen is capable of 
more functions than the mouse. If 
the stroke is recognized as a prede¬ 
fined gesture. Pen for OS/2 exe¬ 


cutes the command that is preas¬ 
signed to the gesture. The pen can 
be used for handwriting control, 
which enables the Pen for OS/2 
user to input handwritten text. The 
text is recognized and converted to 
alphabetic and numeric characters. 
Pen for OS/2 displays virtual 
keyboards. This is useful particu¬ 
larly for a keyboardless system or 


for applications that require a spe¬ 
cialized keyboard. Several applica¬ 
tions that take advantage of the pen 
functions are already in use; for 
example, parcel delivery systems. 
More applications will be available 
as more pen-based systems are 
developed. 

Vera Dulaney, IBM Personal Systems 
Programming, Boca Raton r Fla., is man¬ 
ager of the MVP Pen and Speech Design 
and Development department. She has 
been a member of the OS/2 development 
organization. 

Kevin Lee, IBM Personal Systems 
Programming, Boca Raton , Fla., is a mem¬ 
ber of the MVP Pen and Speech Design 
and Development department. He joined 
IBM in 1983 ■ tee has worked on compiler 
development, transaction processing sys¬ 
tems t language theory, and OS/2. 


Complete code blocks shown 
in this article are available on 
CompuServe's OS2DF2 For¬ 
um, OS/2 Developer section. 
Download file PENCOD.ZIP 
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Figure 1. Sample program for handling pen strokes (continued from page 48) 


Now Ibu Can Easily Backup, 
Restore, Migrate and Manage 
Ybur Workplace Shell Desktop With ... 
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Available 

and Ready 


DesAMan/2™iJthe first 
and only tool designed to 
manage the Workplace Shell™! 

DeskMan/2 for OS/2 is unmatched in its ability to fully exploit 
the power and versatility of OS/2! Managers can use its security 
features to protect access to windows or objects. Administrators 
can easily and quickly standardize a department's desktops for 
maximum job efficiency. Individual users can quickly and 
easily migrate icons, objects and desktops between office and 
home machines. Or use DeskMan/2 to backup and completely 
restore a custom desktop. 

Incorporating the powerful VUEMan/2 m virtual desktop & 
window manager; the potent new WPS snapshot facility; and 
more, DeskMan/2 is packed with features! 


"I installed OS/2* 2J golden code, and DeskMan/2 saved me at least 4 hours 
of tedious labor. I can't imagine being without it." 

David Barnes - Senior Staff member - IBM's OS/2 Executive Briefing Center 


© API i GUJ for local & remote access © Change multiple folders or icons s 


© CID enabled & LAD/3 supported 
© Delete Vtdetotabte* objects 
© Prevent the deletion of any object 
© Query any object tor settings 
© Secure individual windows 
tB Secure groups of windows 


at ones - just drag and drop 
© Full administrative control of ail features 
© Restore, save, migrate any/all objects 
© Total management ot Workplace Shell 
© And much more ... 

© Call DavTech for current Infof 


DevTech 


Development Technologies, Inc. 

Software Development & Technology Transfer 

30B Springwood Road, Forest Acres, SC 29206-2113 W*s: 790-9230 Fax: (603) 73S-0216 
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Object-Oriented Programming 

For the last year and a half, I have been working on a set of class libraries intended to provide a virtual 
operating system, network, GUI, and run-time support system for OS/2 applications. I have learned many 
things and hit many brick wails. Here, I share some juicy tidbits to aid your OS/2 development efforts. 
Although this article is ostensibly C++ oriented, it leans toward giving you insights into OS/2 that are 
necessary to develop a powerful class system. By DEAN RODDEY 


An Example OS/2 C++ 
Class Library System 



Dean Roddty 


ny such class library project is 
a compromise between sup- 
m porting OS/2's power and 
making it somewhat portable to other 
platforms* Although OS/2 catches 
much grief in the press, its problems 
are political, not technical. Sadly, a 
portable class system cannot make use 
of many Presentation Manager services 
because the Workplace Shell is so far 
ahead of the field at this time. Al¬ 
though my project covers kernel and 
GUI services, this article deals only 
with GUI issues. There are times, how¬ 
ever, when I must discuss kernel ser¬ 
vices to fully cover the subject. 


THE BASICS 

The most basic issue for creating a class 
system over Presentation Manager is 
wrapping Presentation Manager win¬ 
dows into a class. If each window is an 
instantiation of a window object, there 
must be a way to link the window to the 
window object. There are two reasons 
for this. First, the window object must 
operate on the Presentation Manager 
window in response to calls to its meth¬ 
ods* Second, window events coming to 
the window must be mapped to win¬ 
dow class methods. 

The first issue is simple; the window 
object can store away a handle to the 


window. The other side of the equation 
is more difficult because window events 
arrive at the window without knowl¬ 
edge of the C++ language* The most 
common approach to this problem is to 
use the window's extra data to store a 
pointer to the window object. When a 
message comes in, the window proce¬ 
dure extracts the pointer to the window 
object and calls the correct methods for 
the event. 

There are a number things to watch 
out for. A window procedure cannot be 
a class method since all class methods 
must have an implied pointer to the 
object. But window procedures are 
called from Presentation Manager and 
must have the prescribed window pro¬ 
cedure format* The answer is to create a 
protected friend method that acts as a 
gateway into the window class. A friend 
procedure does not have an object 
pointer parameter, but it can call pro¬ 
tected class methods. Window messages 
come to the friend method, which 
extracts the window object from the 
window's extra data and calls the real 
window procedure method. 

You should have only one main 
window procedure in the entire pro¬ 
gram so all messages will come 
through it. To achieve this, all classes 
that encapsulate existing Presentation 
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Manager windows should subclass the 
control using the window class's friend 
method* Custom classes can use the 
friend method as their window proce¬ 
dure when they register their window 
class. This seems like a lot of effort and 
somewhat backward, since the whole 
point of Presentation Manager is to 
allow each window class to provide its 
own layer of window procedure, allow¬ 
ing most messages to fall through to the 
layer below. 

Out C++ offers a much more pow¬ 
erful layering capability in its class sys¬ 
tem. Keep in mind that Presentation 
Manager's window procedure system 
is a grand compromise intended to 
offer, to a degree, inheritance mecha¬ 
nisms to procedural languages. In 
doing so, the window procedure sys¬ 
tem abandons strict type checking to 
achieve a pseudo run-time linkage sys¬ 
tem, similar to the C++ virtual method. 
C++ can provide all those layering 
capabilities and more while maintain¬ 
ing stricter type checking. 

To provide the layering system that 
will work with Presentation Manager, 
the basic window class should provide a 
number of virtual methods that corre¬ 
spond to the window events it wants the 
window objects to respond to. Also, it 
should store, as a data member, the 
address of the default window proce¬ 
dure that will be called if the derived 
window class does not want to handle 
an event method. 

For classes that encapsulate 
Presentation Manager windows, this 
would be the Presentation Manager con¬ 
trol's window procedure. For custom 
classes, it should be the default 
Presentation Manager proc. Each event 
method should return a Boolean value 
that indicates whether or not it goes to 
the default proc. If the derived class han¬ 
dles the event, it returns TRUE. Then, the 
window procedure method will return 


the correct "I handled it" value for that 
type of window event. If the derived 
class wants to let the event go to the 
default handler, it returns FALSE. It can 
either not override the event method (in 
which case the default version provided 
by the basic window class will return 
FALSE) or provide some processing and 
return FALSE to let the event go to the 
default handler 

When a virtual method is called, it is 
vectored to the highest level class that 
has overridden it. This class can handle 
the event, call its parent's version and 
provide more processing, or return FALSE 
to force the event to go to the default 
handler. This allows for the incremental 
improvement of functionality that C++ 
is so good at. But beware that we live in 
an imperfect world: sticky issues arise 
when you implement a cleanly layered 
system on top of a system that it cannot 
control totally 

STICKY ISSUES 

There is a nasty side effect to this kind of 
system* Since the entire structure is 
based on the fact that all windows have 
a pointer to a window object, there is no 
easy way to support existing non-C++ 
code within this framework. If you cre¬ 
ate an non-C++ window as a child of 
one of your new objectified windows, it 
will almost certainly post or send mes* 
sages to its parent or owner. This mes¬ 
sage will go to the central window pro¬ 
cedure, which will attempt to extract a 
pointer to the window object and call 
methods therein. At this point, your 
application will crash* Certain schemes 
could solve this problem, but they 
involve too much overhead and com¬ 
plexity, unless you are desperate. 

Another sticky issue involves ^CRE¬ 
ATE messages. This is not an issue for the 
classes that encapsulate Presentation 
Manager controls because you will 
probably just subclass them/Because 
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subclassing cannot happen until 
the window is created, you will 
never see the WH_CRE ATE message. 
But there is a problem when you 
are dealing with custom window 
classes. If you add a virtual 
bCreateO method to your basic 
window class, you will discover a 


quirk of C++: when you call a con¬ 
structor for a class that is high up 
the class hierarchy, the construc¬ 
tion actually starts at the bottom. 
This is necessary, since each class 
level needs to call its parent con¬ 
structor. Eventually, the call chain 
reaches the lowest level construe- 
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tor, which completes its function 
and starts back upward. 

In my system, the actual call to 
UinCreateWindovO takes place at the 
lowest-level WINDOW class. So, when 
the WW_CREATE message arrives, the 
object is really a WINDOW object, and 
the virtual method will not reach 
the original calling class. This 
makes sense because that class has 
not initialized its members and 
would not be in a position to deal 
with the event. 

But this is not a big issue. The 
reason for the WM_CREATE message is 
to initialize the window state. But 
in our objectified system, the con¬ 
structor serves that purpose. So, 
have the window procedure 
method eat the WH_CREATE message. 

PRESENTATION SPACES 

The vast majority of Presentation 
Manager windows use cached pre¬ 
sentations spaces, meaning that 
they only exist for the length of 
time of the WM_PAINT message. This 
makes sense; keeping TOOK of 
memory or more (the amount 
needed for a persistent presenta¬ 
tion space) for every cell in a 
spreadsheet doesn't make sense 
when it is needed infrequently. 
Other windows use more complex 
presentation spaces that are persis¬ 
tent and use different coordinate 
systems. 

Here is a list of some potential 
problems with presentations spaces: 

* Persistent and cached presenta¬ 
tion spaces must be created and 
destroyed differently Also, any 
invalidation of a SYIWCPAINT win¬ 
dow during Wtt.PAINT processing 
will cause a recursive call to the 
WM.PAINT code. 

* Advanced applications often 
paint to a single window via 
multiple threads, each of which 
really needs its own presentation 
space. 

* Two mutually exclusive color 
schemes (indexed or RGB) may 
be used. 
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* Some GUI resources are tied to 
the presentation space on which 
they were created and become 
useless when the presentation 
space is destroyed. 

* Each layer of the class system 
cannot assume the state of the 
presentation space that they are 
given to paint on* Nor can they 
modify it, unless that is the pur¬ 
pose of the method that is called* 

We dealt with the first two 
problems by creating a PAINTBRUSH 
class. This class's constructor 
accepts a window object that it 
should operate on. It extracts the 
window handle and creates a pre¬ 
sentation space from it. This PAINT¬ 
BRUSH object then can be used to 
paint on the window. The PAINTBRUSH 
class provides methods for all 
desired graphics primitives. At first, 
we stored the presentation space in 
the window, but the recursive 
nature of painting and the occa¬ 
sional need to have multiple threads 
paint to the same window required 
a change to the architecture. 

Even so, this new system is a 
compromise: now we have two 
objects that are linked via a com¬ 
mon system resource. If the win¬ 
dow object is destroyed, any fur¬ 
ther access to the PAINTBRUSH object 
will cause errors. There is a pro¬ 
tected constructor available to the 
WINDOW class to handle the special 
case of WM_PAINT messages. And 
there is a third constructor that cre¬ 
ates a persistent presentation space 
and accepts extra parms for page 
units. A flag in the PAINTBRUSH object 
indicates the type of presentation 
space, so the destructor can dean it 
up appropriately. 

In my opinion, the second 
problem is insurmountable if you 
desire to create a consistent, plug- 
n-play environment. Therefore, we 
avoided the problem by using only 
RGB mode. This may be unaccept¬ 
able to many because of memory 
usage issues, but the Year of the 
True Color Card is not far away. 


and we are looking forward, not 
backward. 

We created an RGBCLR class that 
handles all the niceties of RGB 
color values. We provided a global 
set of named RGBCLR objects that 
correspond to the usual 16 colors, 
plus some special ones. We pro¬ 


vide a CLRPAL class for those appli¬ 
cations that must use indexes. 
When converting RGBCLR objects to 
a form passable to GPI APIs, you 
can reduce overhead greatly by 
having the color component mem¬ 
bers in the same order as the 
Presentation Manager RGB values. 


Smart-Lock 
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Then, you can provide an implicit 
conversion method that will refer¬ 
ence the first member and derefer¬ 
ence it as a long value. This allows 
RGBCLR objects to be passed directly 
to GPI APIs with no intervening 
conversion to a temp variable. 

The third problem is a problem 
primarily for logical font and 
bitmap IDs* Since fonts pose par¬ 
ticular problems, I will cover this 
third problem shortly. 

We dealt with the fourth prob¬ 
lem by creating a GRAPHICATTR class, 
whose constructor accepts a PAINT¬ 
BRUSH object and an attribute bun¬ 
dle identifier. Presentation Man¬ 
ager supports a number of 
attribute sets that can be saved and 
restored as a group. The GRAPHICATTR 
class saves a particular bundle and 
restores it when it is destroyed. 
This greatly simplifies the logic of 
the medium-level graphics output 
methods that perform lower-level 
operations on behalf of the caller. 
They simply create GRAPHICATTR 
objects to store the attributes they 
will modify. Any exit from the 
method destroys the object, restor¬ 
ing the caller's attributes. Of 
course, this saving and restoring of 
attributes should be minimized 
because it has performance costs* 
Another possibility is to add the 
Presentation Manager attribute 
push and pop mechanism to the 
PAINTBRUSH class, but it would not 
have the same automatic cleanup 
mechanism as a separate object. 


FONTS 

Fonts are sticky; they usually are 
installed by the user, rather than 
built into the operating system. 
They have numerous parameters 
and a number of formats. 
Sometimes bugs are in the font 
files themselves. If you look at any 
commercial package (object ori¬ 
ented or otherwise) you can easily 
recognize that fonts can be compli¬ 
cated. Some packages don't sup¬ 
port fonts at all, and others pro- 


// This is the skeleton of the basic WINDOW class. 

II 

class WINDOW 

{ 

public : 

It Constructors/destructors 

VIND0W(_); 

II 

It Virtual 'event' methods handle incoming events from 
II PM, These defaults all return FALSE, to let the 
// event go to the default handler. 

// 

virtual BOOL bDestroyO {return FALSE;} 
virtual BDOL bPaint(AREA arealnvalid) {return FALSE;} 
virtual BOOL bSizeChange(AREA areaNew 
, AREA areaflld) {return FALSE;} 

// 

// Non-virtual methods handLe operations on windows from 
II client code, 

// 

VOID HideO; 

VOID ShowO; 

VOID SizefAREA areaNew); 
protected : 

//A friend that is the actual PH window proc 
friend MRESULT EXPENTRY .mresPreprocessorfHWNDjULONG^PARAM^PARAM); 
II The method that is called by mresPreprocessor 
HRESULT jnresMsgHandELeKHWND, ULONG, MPARAM, HPARAH); 
private : 


HWND 

__hwnd; 

PFNVP 

__DefWndProc; 

ULONG 

„_ulld; 


}; 

II 

It 

// The friend function that is the actual window procedure. This 
II guy is a friend but cannot access private class members or 
// data. 

It 

MRESULT jnresPreprocessor( HWND hwnd, ULONG ulMsg, MPARAH mpl, MPARAfl mp2) 

{ 

It 

II Eat the WM_CR£ATE message, but store away the passed object 
II pointer, 

if CuUMsg « WH_CREATE) 

{ 

WinSetWindowPtr(hwnd, QWL_USER, mpl); 
return 0; 

} 


Figure 1 Skeleton of the basic Window class (continued on page 57) 
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II 

// Extract the object pointer and call the message 
// handler method. 

It 

WINDOW* pwndlhis = WinQueryWindotfPtr(hwnd, QWL.USER); 
return pwndThis-> mresWsgHandlerfhwnd, ulMsg, mpl, mp2); 

}; 

It 

// This class method is called by the actual window proc, This 
// guy has accessed to window object data and methods. 

It 

MRESULT WINDOW::_mresMsgHandler(HVND hwnd 
> ULQNG ulMsg 
f MPARAH mpl 
p MPARAH mp2) 

{ 

if (ulflsg WM PAINT) 

{ 

RECTI rectllnvalld; 

HPS hPS; 

// Prep the PS and get the invalid recti 
hPS = WinBeginPaint{__hwndThis t 0, ferectllnvalid); 

it 

// We call a special PAINTBRUSH constructor that is for 
// the special case of WM_PAINT. We convert the invalid 
// rectlangle to an area to pass along. 

It 

AREA arealnvalid(rectllnvalid # eNONINCLUSIVE); 

PAINTBRUSH ptbTarget(hPS); 

II 

It If the class handles it, return the correct code, 

II Otherwise, let it go to the default handler. 

II 

if (bPaint(ptbTarget, arealnvalid)) 
return 0; 

II 

It Note: No WinEndPaintQ!! The PAINTBRUSH'S destructor 
II will handle this. It win be destroyed on the 
// exit from this block. 

II 

> 

else if (ulMsg = WM SIZE) 

{ 

If Convert the PM info into areas 

AREA areaNewtt), 0, SHORTlFRQMMP{mpl), SHORT2FR0MMP{mpl)}; AREA area01d{0, 
0, SHDRTlFRQMMP(mp2), SH0RT2FR0MMP(mp2)); 

If 


Figure t. Skeleton of the basic Window class (continued on page 60j 


vide very limited support. On this 
issue, you may have to bite the 
bullet. If your applications require 
heavy font usage, and no class sys¬ 
tem is available that can provide 
that support on the desired plat¬ 
forms, you may have to back off 
some platforms or do a lot of per- 
platform coding. 



OUR APPROACH 

We abstract fonts very heavily due 
to their inherent cross-platform 
complexity and because there are 
many font problem areas just in 
Presentation Manager. We created 
a FONTINFO class that is just a front 
end to the FDNTMETRICS structure of 
Presentation Manager, The appli¬ 
cation can request a linked list of 
FONTINFO objects that match a face 
name and a somewhat limited set 
of attributes. We tried to limit the 
attribute set to a reasonable subset 
that would be useful yet portable, 
but there will probably be prob¬ 
lems in the first port. Some attrib- 
utes may just have to be ignored 
on some platforms. 

Also, only a selected set of 
FGNTMETRICS fields is accessible so 
that extremely Presentation Man¬ 
ager-centric font manipulations are 
not spread around the application. 

To use a font, you must create 
a logical font ID. As discussed pre¬ 
viously, when a presentation space 
is destroyed, the current font selec¬ 
tion is lost. Also, in subsequent 
platform ports, you cannot always 
foresee the associations between 
window state and fonts. 

For these reasons, and because 
there are only 254 font IDs avail¬ 
able per process in Presentation 
Manager, we decided to keep 
strict control over fonts, to the 
extent that we do not have a font 
class. Instead, the application finds 
FONTINFO objects that represent its 
desired fonts and asks a PAINTBRUSH 
object to create a font of that type. 
When it wants to the use the font, 
the application passes in a font 
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name that it will use later. 

So, the PAINTBRUSH keeps a list of 
font IDs associated with it. This 
puts the PAINTBRUSH in a position to 
manipulate font IDs to match its 
current state as needed. It also 
allows it to destroy any associated 
font IDs when the presentation 


space is destroyed to avoid a com¬ 
mon error of stranding font IDs 
and running out of them later. 

DIALOG WINDOWS 

Dialog windows pose more prob¬ 
lems. There are some basic ap- 
proaches: You can call WinLoadDlgO, 


which will load up the dialog and 
create all the controls. Then, you 
can create after-the-fact window 
objects for all the controls. But we 
wanted to allow each dialog-win¬ 
dow-derived class to control the 
creation of the control windows so 
that more specialized versions 
could be created and initialized in 
a way that is appropriate for that 
dialog. We could have passed the 
window handle and Presentation 
Manager window class of each of 
the controls to the derived class, 
but that would expose Presen¬ 
tation Manager-specific informa¬ 
tion to the outside world. 

We solved this problem by 
interpreting the dialog template 
manually, allowing the basic dia¬ 
log class (or a derived class) to 
handle the creation of the controls. 
Reading a dialog template is not as 
difficult as it might seem, except 
that the documentation is ex¬ 
tremely insufficient. Again, do not 
create a virtual method to allow 
derived classes to handle control 
creation because the creation hap¬ 
pens in the constructor. We used a 
callback function passed to the 
constructor. The Presentation 
Manager class type is converted to 
the equivalent class name, and any 
control size and position informa¬ 
tion is passed along. If the callback 
returns a null pointer, the dialog 
window creates the default type of 
window object. 

By the way, another good use 
for this knowledge is for building 
dialog templates in memory on the 
fly and letting the dialog process¬ 
ing code handle the grunt work of 
user interaction. 

The devil is in the details, but 
these are the basic steps to handle 
your own dialog creation. First, 
use DosGetResourceQ to load the dia¬ 
log resource. This gets you a read¬ 
only buffer with the template defi¬ 
nition. Load the address into a 
PDLGTEMPL ATE variable to start the 
parsing. The last field of the DLGTEM- 
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value than Rhetorex. 

With Rhetorex voice platforms, 
you’ll get state-of-the-art DSP- 
based technology, designed from 


the ground up for reliability. 
Sophisticated DSP algorithms 
give you unparalleled perfor¬ 
mance. Best of all, enhance¬ 
ments to algorithms are made 
via software upgrade. 

And Rhetorex products help 
you develop applications 
quickly. All components 
include device drivers, a 
straightforward API, and 
sample programs. Friendly, 
free technical support is 
available at any stage of 
development. 

For the best value in CTI 
technology-from our 2 and 4 
port voice processing boards 
and fax boards, to our 24-pon 
platform-then give Rhetorex a 
call. (408) 370-0881. And start 
making CTI a reality. 



RHETOREX 


Rhetorex, Inc. 

200 E. Hacienda Avenue 
Campbell, CA 95008-6617 
Tel. (40S) 370-0881 
Fax (408)370-1171 


All trademarks identified by the ™ symbol are trademarks of Rhetorc*,. Inc. 
Ail other innicmsirks belong io their respective owners. © 1993 Khctorc*, Inc, 
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PUTE structure is an array of 
DLGTTTEM records, but the array has 
only one entry since the actual 
number of dialog items following 
the template is variable. 

Use a PDLGTITEM variable to 
work your way through the dialog 
item structures (pltem = &pDlg->adl- 
gti[G]). The Oth dialog item repre¬ 
sents the dialog window itself. 
Each dialog item structure contains 
the information you need to create 
that item and the number of child 
windows it has. The child win¬ 
dows follow it in the list so the 
arrangement is "depth first." In 
our system, we do not support 
nested dialog controls, so we 
worry only about the number of 
children of the dialog itself. 

Next, create the dialog window 
frame using the information in the 
first dialog item structure. You will 
need to check the styles to find out 
whether the size and position infor¬ 
mation is relative to the screen, par¬ 
ent window, or mouse and then 
add the dialog position to the origin 
of the screen or window or to the 
current mouse position. The control 
data for the dialog is a ULONG with 
the FCF_xxxxx flags in it. You need 
this to create the frame window 
with the correct frame controls. 

For the modal processing to 
work correctly, you must calculate 
the correct owner of the dialog, 
which will not always be the 
owner window that the user 
passed. So, starting with the owner 
window that the user indicated, 
use WinQueryWiiidowC) to work up the 
ownership chain until you reach a 
window that is a direct child of the 
desktop window or a null window 
handle. Pass this window as the 
owner of the frame window. If you 
do not do this, often you will find 
that the supposedly modal dialog 
does not stop you from interacting 
with other application windows. 

Now, call WinCreateWindowO to 
create the frame, passing a FRAMEO 
DATA structure as the control data. 


At this point, just create it so it is 
invisible and has no size. You 
don't know the size at this point 
because the size information in the 
dialog item is actually the size of 
the "client area" of the frame 
(although there is no real client 
window in a dialog). 


After frame creation, use the 
dialog item size and position infor¬ 
mation in a call to WinCalcFrameRectO 
to calculate a frame that will con¬ 
tain a client area of that size. Before 
you size and position the frame, 
adjust the values to ensure that it 
does not hang off the screen. Then, 
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you can size and position the 
frame {but not show if you want to 
process it modally). To make the 
client area display the correct color, 
use YinQuerySysColorO to get the 
SYSCIRJIALQGBACKGRQUND colon Call 
WinSetPresParam to set the frame's 
PP_BICKGROUNOCOL OR. 


Now, you can loop through the 
remaining dialog items {which rep¬ 
resent dialog controls) and create 
them as owned children of the 
frame* One oddity is that you must 
start at the last control and work 
backward to make the Presentation 
Manager dialog window's tab key 
code work correctly. By going in 
reverse, the first control in each 
group (which has the W£_GR0UP 
style) will be the last window cre¬ 
ated in the group. 

If you intend to support nested 
controls, you should do this via a 
recursive call. Note that, since 
dialogs have no client window, 
you actually create the controls rel¬ 
ative to the frame. The position 
information in each dialog item 
does not take this into account, so 
use the ¥H_pUERYBQRDEBSIZE message 
to get the border size and add it to 
the origin of each control. 

All size and position informa¬ 
tion in dialog templates is in dialog 
units, not pels* Use the Win- 
WapDlgPointsO function to map the 
dialog units to pels before using 
them* And last, the dialog template 
structure contains the index of the 
control that should get the initial 
focus* If it is QxFFFF, use WinEnum- 
OlgltemO with the EDI_FIRST!ABITEM to 
find the first item with the VS.TABSTGP 
style and give it the focus. 

Now, you can either use the 
newly created window like a regu¬ 
lar window (which is useful for 
creating your program's main win¬ 
dows via the Dialog Editor) or pro¬ 
vide a method in the dialog class 
that calls yinProcessDIgO to process 
the dialog modally Initially set the 
default procedure to the default 
window procedure* If the dialog is 


// If he handled it, return correct code, else let it go 
// to default handler* 

// 

if (bSizetareaNew, areaOld)) 
return 0; 

} 

else if (ulftsg — mm) 

{ 

... Whatever other messages you want to handle 

} 

return „DefWndProc(hwnd, ulMsg, mpt, mp2); 

> 


Figure 1 Skeleton of the basic Window class (continued from page 57) 


later processed modally, switch it 
to the default dialog proc to avoid 
problems* 

POINTS AND RECTANGLES 

One of the best things you can do 
for yourself in a GUI class system 
is to create powerful and flexible 
classes for dealing with points and 
rectangles* There are three reasons 
for this* 

First, two types of rectangles 
are in Presentation Manager, inclu¬ 
sive and noninclusive* In Presen¬ 
tation Manager applications, a con¬ 
stant problem is keeping up with 
which kind of rectangle is required 
and which kind you have. 

Second, any new platform you 
port to may have totally different 
concepts for rectangles. 

Third, you waste a vast 
amount of time in the average, 
large Presentation Manager appli¬ 
cation doing grunt work calcula¬ 
tions and manipulations on points 
and rectangles. Such code is inher¬ 
ently Presentation Manager-centric 
and ripe for maintenance errors. 

We eliminated this problem by 
creating a POINT class to handle 
points and an UREA to deal with rec¬ 
tangles. The AREA class represents a 
POINT origin and a width and 
height value that is always inclu¬ 
sive. The outside world deals 
exclusively with POINTs and AREAs, 


and the lowest-level class methods 
(that actually call Presentation 
Manager) handle converting in 
and out as needed. 

The AREA class is particularly 
powerful; it inflates and deflates 
itself, calculates its center, calcu¬ 
lates horizontal and vertical per¬ 
cents of itself, centers other areas 
within itself, offsets its origin, and 
so on. The more standard opera¬ 
tions you incorporate into the AREA 
class the better. It should have 
methods and constructors that 
build AREAS from RECTLs, a PQINTl and 
width and height, two PGDITLs that 
represent opposite corners, SWP 
structure, and so on. It should also 
have methods to create these 
Presentation Manager structures 
from an AREA, which greatly simpli¬ 
fies the internal code that has to do 
the conversions. 

The use of POINT objects can be 
eased greatly by storing the mem¬ 
bers in the same order as a POINTL 
and having an implicit conversion 
operator that references the 
address of the x member. This 
allows POINT objects to be passed 
directly to GPI calls with no inter¬ 
vening conversion. 

PRESENTATION MANAGER 
TYPES AND BIT FLAGS 

One way to increase the type safe¬ 
ness and portability of your class 
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system (without introducing over- 
head) is to redefine the Pre¬ 
sentation Manager types as C++ 
enumerated values* C++ allows 
enumerated values to be given 
explicit values, so you can create, 
for instance, an enumerated value 
called sLINESTTLES for the LINE* 
TYPE_xxxxa Presentation Manager 
values. 

If your line type setting 
method accepts an eLXNESTYLES 
parm, it gets much stricter type 
checking than the generic bit flags 
that Presentation Manager uses* 
But, internally the line style setting 
method can pass the enumerated 
value on to the GPI API, and the 
compiler will convert the enumer¬ 
ated value automatically to a long 
value* A side effect of this trick is 
that you keep Presentation 
Manager-centric constants and 
types out of the source code, eas¬ 
ing future ports. It also allows the 
class designer to exclude certain 
flags because those flags may limit 
portability. 

THE BIG PICTURE 

If you decide to write your own 
Presentation Manager class sys¬ 
tem, be aware that you likely will 
be very frustrated* C++ represents 
such a great step in power over the 
procedural systems (upon which 
most class systems must be imple¬ 
mented) that a totally consistent 
class system might be impossible* 

We started the classes by 
mainly implementing basically run¬ 
time-oriented services, such as 
strings and containers. Since these 
services depend only on memory 
allocation, they are free to follow 
almost any consistent class mecha¬ 
nisms you implement The kernel 
services that followed were also 
quite easy because most kernel ser¬ 
vices are passive and do only what 
you tell them. Threads were not too 
difficult. 

Then came the GUI, whose 
complexity, event-driven nature. 


and troublesome resource interrela¬ 
tionships often stymied my plans. 
This is irksome even now because I 
feel that consistency is next to godli¬ 
ness m class system development 
Developer spin-up time and reac¬ 
tionary fire-drill programming are 
very expensive, and inconsistency 
greatly increases spin up and 
decreases reliability* A class system 
in total control can provide many 
more safety nets and self examina¬ 
tions, quickening development and 
relieving much of the testing burden 
for the developer and putting it into 
the code itself. 

The object-oriented frame¬ 
works and (eventually) operating 
systems to come from IBM will 
reduce these problems greatly by 
providing an object-oriented plat¬ 
form to build on. Of course, the 
irony is that they also will make 


most of the effort that I have dis¬ 
cussed here redundant. 

If you can't wait, be sure to 
take a good look at the operating 
methods of your future object-ori¬ 
ented program's framework* 
Then, arrange your class system 
accordingly. Hopefully, you will 
be able to just pull out your 
lower-level classes and replace 
them with new ones, leaving your 
higher-level (application-specific) 
classes mostly intact. It may never 
happen, but you have to try! 

Dean Rod day is senior software engineer 
at Quantitative Medicine of Annapolis, 
Md. He has a relationship with his com¬ 
puter that is probably illegal in some 
states f but he is seeking help. He is cur¬ 
rently working to move QMIs QS/2-based 
Clinical Information System to an object- 
oriented platform. 


GET FAST ANSWERS 

To Your Development Questions 


You need to do two things: 

• Go on-line with 
CompuServe®. 

# Use Golden 
CommPass to do it* 

CompuServe hosts OS/2 
developer and user 
forums. IBM 
developers have 
responses to anything 
that’s got you stuck. 

Other OS/2 
programmers and 
enthusiasts are 
there, too, comparing 
notes and giving feedback. 
It’s definitely the place to be. 


Golden CommPass' 

05/2® Navigation 5orrwAEE 

Creative Systems Programming Corporation 
( 609 ) 234-I5QQ • Fax: (609) 234-1920 
Internet: 71511.151 @CompuScrve.com 



Time is money when you connect 
to CompuServe, and Golden 
CommPass saves you both. It lets 
you compose your questions 
off-line, send them in a 
flash and disconnect It 
gets your replies 
while you’re 
busy programming. 


Golden CommPass 
keeps your develop¬ 
ment schedule on 
course* The fact is, 
the sooner you start 
using our program, the 
sooner they’ll be talking 
about yours* 
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NEW FIBER OPTIC 

Pen Computing 

FOR THE DESKTOP 


U nder OS/2® 2,1, this 
new, fast input device al¬ 
lows you to take advantage of 
all the new drag and drop icons 
for fast target selection. Run ev¬ 
erything the mouse does and 
more. Frustrated because you 
can f t sign your name with a 
mouse? Add IBM's Pen for OS/ 
2 software to create gesturing, 
sign your name and use hand¬ 
writing recognition. Finally, 
click and go on your desktop 
monitor is a reality. 

WHAT COULD BE 
EASIER? 

How much easier can pointing 
your finger be? Just hold the 
PEN in your hand and tap the 
tip at any CRT computer 
screen - your computer ex¬ 
ecutes the command and 
you're off. A mouse simply 
cannot keep up! 

GET YOUR DESK BACK, 

Increase speed and accuracy 
and save desk space at the 
same time! One reason PENS 
are so easy to use is that they 
don't clutter up your desk 
with pads and hardware. You 
don't need any desk space for 
the PEN, The PEN stores 
neatly on the side of your 
monitor in a convenient 
holder. 





WAKP SPEED ™ has developed a NEW fiber-optic 
PEN for any computer running OS/2. 


P-Ucrtei? 




j* 


CURSOR, CURSOR, 
WHERE'S THE CURSOR? 

This game just became obso¬ 
lete, You no longer need to go 
on a mouse hunt to find your 
cursor. Just ignore the cursor, 
touch the PEN to the target,,, 
the cursor just found you, in¬ 
stantly, This happens so in¬ 
credibly fast you'll think the 
cursor is invisibly attached to 
the PEN, 

JUST PLUG AND GO . 

The WARP SPEED PEN for 
OS/2 comes complete with an 
adapter card (ISA or MCA), a 
high quality Stainless Steel PEN 
and PEN driver and calibration 
software for OS/2, Gesturing 
and handwriting recognition 
are available on IBM's Pen for 
OS/2 software, 

Dieif rpcr 

INTRODUCTORY OFFER* 

Make the jump to a WARP 
SPEED PEN for OS/2, try it for 
30 days. If you don't agree that 
the PEN is far superior to the 
mouse, simply return it to us 
in its original box, and we will 
refund your money, 
no questions asked. 



Handwriting recognition, gestures, notes etc. are alt made simple 
with the addition of IBM's Pen for OS/2 software. 


W&lsMasiWWA 


Can TOLL FREE (800) 8744315 or (505) 258-5713 to order your WARP SPEED 
PEN for OS/2 and we will include IBM's Pen for OS/2 software for the low price of 
$199.99- You save $90.00 off the retail price of $289.98 for both products. This is a 
limited time offer. Use your credit card or mail a check to Warp Speed[ 1086 Mechem 
Drive r Ruidoso, NM 88345. 

WARP SPEED is a trademark of Warp Speed Light Pens Inc. OS/2 and IBM are Trademarks of IBM Corporation 
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The IBM Pen for OS/2 product enables applications to cross the human-centric barrier. This article 
explores an example of how a pen-centric application should be designed and how simple it can be to 
develop using Pen for OS/2. By SARK A J. MARTINEZ 


A Natural User Interface: 
Writing a Pen-Centric 
Application 


^^■en technology has introduced a 
whole new set of possibilities in 
V the world of application software. 
Software can now be written in pen-cen¬ 
tric fashion. Pen-centric applications are 
those that have been written expressly 
with pen entry and manipulation in 
mind. A pen-centric application can per¬ 
form specific preprogrammed tasks as a 
result of what a user does with the pen, 
be it handwriting or gesture entry. 

Application programming takes on 
an exciting aspect when coupled with 
OS/2's pen extensions. One such pen¬ 
centric application is called Contact/2. 
Contact/2 is a demo application I wrote 
in five weeks while working in IBM's 
Mobile, Pen, and Voice (MVP) software 
development team. A unique approach 
was taken in developing Contact/2, the 
core ideas being the pursuit of an inter¬ 
face using a real-world paradigm, the 
value of function, and of course an easy- 
to-use pen-centric approach. This appli¬ 
cation is an example of how you can 
add pizzazz to your applications and 
improve their ease of use by the mere 
fact that they follow a real-world model. 

CONTACT/2: A PEN CENTRIC DEMO 

Basically, Contact/2 is an address book. Its 
intention is to communicate with the peo¬ 
ple and business contacts stored within 


the book. This application achieves its 
entry into the real-world paradigm by 
being represented as a true-life book, com¬ 
plete with a cover, book tabs, business 
cards, and an index page. There's even the 
capability to attach jotted down memos 
via sticky pads to any entry in the book. 

Contact/2 can give the user a simple 
way to communicate with other people 
via fax, e-mail, telephone, alphanumeric 
paging, or LAN messaging, ft includes 
some multimedia capabilities; it allows 
the playback of prerecorded messages 
attached to the cover, the index page, and 
the book's entries (so that the people in 
your book can tell you a little about them¬ 
selves). Communications functions were 
tied in easily by the use of OS/2's 
dynamic data exchange (DDE). By using 
DDE and off-the-shelf applications, we 
saved a lot of time and money by not 
having to develop new code or compete 
with existing communication software. 



Sarktt ]. Martinez 


THE DESIGN APPROACH 

Our approach in designing this particular 
application was different. The emphasis 
was on visuals—something often saved 
for last. The coding was merely an 
enabler for the end result. Painstaking 
care was taken up front to create the look 
and feel of an actual book, including the 
artwork for its dramatic cover. 
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LOOK AND FEEL FIRST 


mm 


First we designed the book's over¬ 
all visual appearance and user 
interface using PowerPoint 3.0. 
Next, the graphics for the cover 
(welcome page) of the book were 
created using CorelDraw 3.0 and 
Adobe Photoshop 2.5. The images 
were saved as bitmaps and are dis¬ 
played on the welcome page when 
its dialog box is loaded. 

Notebook Control-Made to 
Order. After the user interface 
design and visuals were created, 
work began on implementing the 
interface using the Notebook control. 
If there has ever been a question as 
to when to use the Notebook control, 
this sort of application is what it 
was intended for! There is no bet¬ 
ter vehicle in representing this type 
of information to a user. 

Aiter we had finished the user 
interface framework, we created a 
database to store address book 
entry information. Along with 
storing the usual information, we 
added the ability to store a bitmap 
for each of the entries. We created 
generic bitmaps, using OS/2's Icon 
Editor for male and female entries, 
and a bitmap to indicate a business 
entry. We provided a way for users 
to add their own bitmaps. 

Next, the pen portion was 
enabled by using several Pen for 
OS/2 APIs and messages. Last, 
DDE was folded into the code, 
enabling Contact/2 to communicate 
with various off-the-shelf "helper" 
applications such as IBM's Mul¬ 
timedia Extensions, cc:Mail, and 
other communicating applications. 
From design to coding, everything 
was done on OS/2 2.1. 


THE GESTURES 

Pen for OS/2 APIs follow the 
same format as other OS/2 2.1 
APIs, making it easy to learn. 
Anyone creating software can be 
a quick study in getting pen capa¬ 
bility into their applications. Let's 
take a look at how simple it is. 



Figure f. The cover of the Contact/2 address book 


Pen plays a major role in 
Contact/2's book paradigm in 
both navigation and the initiation 
of its communication features. 
Following is a list of Contact/2 
premapped gestures achieved by 
using the Pen for OS/2 messag¬ 
ing framework. The gestures 
defined by Pen for OS/2 retain 
their predefined function unless 
overridden by another applica¬ 
tion's mapping. There are 58 ges¬ 
tures available for mapping: 

-> Forward a page 

<- Backward a page 

R. Remove entry 

A. Add entry 

IL Update entry 

C* Copy 

? Help 


O. Print (output) 

P. Send Pager Message 

0. Dial a number 

V * Play a voice capsule 

M. Mail a note 

F. send a fax 

L. send a LAN message. 

Letter gestures involve a tap of 
the pen as the final stroke. 

How does Pen for OS/2 deter¬ 
mine if a user is entering a gesture 
rather than a letter (handwriting 
recognition)? It all comes down to 
pauses. As long as a user does not 
pause the pen on the tablet before 
or during the execution of drawing 
a gesture, the system will treat it a 
gesture. If a pause is present, the 
system will attempt to recognize it 
as a letter. 
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RECOGNITION 

Gesture and handwriting recogni¬ 
tion can be monitored and acted 
upon by processing the WM.RECQ 
message. An application receives 
a WM.RECQ message whenever a 
recognition event occurs. The 
Contact/2 application redefines 
several gestures. Thus, the appli¬ 
cation performs special process¬ 
ing of the WM_REC0 event to over¬ 
ride the system's default 
processing of the gesture. 

In our application, several 
window procedures are defined; 
each time a recognition event 
occurs on one of these windows, I 
repost the parameters that enter 
into the WH.RECO event into a mes¬ 


sage called YM_HV_REC0, which is 
defined in the topmost client win¬ 
dow (the Notebook control). By 
doing this, we need to define only 
one procedure to handle all the 
gesture processing information. 

When you process a WM_REC0 
message, the second message 
parameter contains the RECDDATA 
structure. A virtual ID can be 
accessed through this structure. 
The virtual ID indicates whether 
the gesture was a letter gesture or 
another specific symbol gesture. 
If it is determined that the gesture 
was a letter gesture, the character 
code stored in the RECOOAT A struc¬ 
ture can be accessed. This will let 
you determine exactly which let¬ 



Figure Z Entries are represented as business cards 


ter gesture was recognized. 

Finally, a value of TRUE must 
be returned from the WMJECO event 
to override the system's default 
execution of the gesture. Notice 
that the gesture's hot-spot coordi¬ 
nates can be mapped easily to the 
corresponding window handle 
that resides at that coordinate. 
This can be achieved by using the 
WinMapWindowPoints API, which is 
detailed in Figure 3. 

Handwriting recognition can 
also be achieved easily with the 
use of the Handwriting control. No 
special message capture or mes¬ 
sage sending needs to be made. 
Handwritten words are recog¬ 
nized automatically as long as a 
value of FALSE is returned from 
the WM_CONTRGL event. This can be 
done by returning the result from 
WinOefWifidouProc in the WH.CONTRQL's 
default case statement. This 
causes the system to take default 
processing of handwriting recog¬ 
nition events. The code segment 
in Figure 3 shows how to process 
recognition messages for gestures. 




THE SKETCH CONTROL 

A user can access the sticky pad 
by tapping on the paper clip but¬ 
ton. This interface is intended to 
let a user jot down quick notes 
about an entry. Contact/2's sticky 
pads were created using the sketch 
control provided by Pen for 
OS/2. Finally, a way to jot down 
thoughts through sketching! This 
is shown in Figure 4. 

The sketch control was in¬ 
cluded into a dialog box within a 
.DLG file. The dialog procedure 
needs to process SKN_STROKE_ A DO 
messages to save the strokes that a 
user may draw in to the control. 
Then, these strokes can be saved 
into a file and later be retrieved for 
display purposes. This is shown in 
Figure 6. These saved strokes 
could also later be recognized and 
transformed into text (delayed 
recognition). 
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HRESULT APIENTRY NoteBookCUentProcOWND hwnd, ULONG msg, MPARAH mpl # HPARAH mp2 ) 
case WH^RECO: 

// post the message back to this window, all windows will post this message back to this window,*. 
tfinPostHsg(hwndOient, WHJYJECO, (HPARAH)hwnd f mp2); 

// need to return true... 
return (HRESULT)TRUE; 

// look at all gestures done ontop of Contact/2 
case WH.HYJtECQ: 

ProcessRecofropl, mp2); 
break; 

> 

HRESULT EXPENTRY BusinessCardDlgProcf HWND hwnd, ULONG message, HPARAH mpl, MPARAM mp2 ) 

{ 

case UH.REC0: 

// post the message back to the client window, so that all gesture work stems from there. 
VinPostMsg(hwndQient, WH_MY_REC0, (HP ARAN)hwnd, mp2); 

// need to return true... 
return (HRESULT)TRUE; 

} 

VOID ProcessReco(NPARAH mpl, HPARAH mp2) 

{ 

RECODATA *recodata; 

// someone drew a letter gesture 

if {recodata->virtual_id == VE^LETTERGESTURE) { 

// user wants to play back a greeting 
if (recodata->char^code "V') { 

index = (ULONG) yinQueryVindovULongfhundDlg, 0); 

// find out which card the gesture was done on 
WinHapWindowPoints(HWN0_DESKTOP # hwndDlg, 

&(recodata->ptlHotSpot), (LONG)l); 
yinQueryWindowRect(hwn<i01g, &rect); 

// playback the entries voice message, since you know what card the gesture was done on 

> 

// user wants to send a Pager transmittion 
else if (recodata->chareode == 'P') { 

} 

// user wants to send Hail 

else if (recodata*>charecode == 'H') { 

} 

// user wants to Add an entry to the book 
else if (recodata->char_code == 'A') { 

} 

// other gestures to take action on 


Figure 1 Code enabling gesture recognition (continued on page 67) 
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Figure 1 Code enabling gesture recognition (continued from page 66) 



Figure 4 , The sketch pad interface 


Basically, the 5KN_STRGKEJDD mes¬ 
sage stores all the strokes in a stroke 
buffer that can later be retrieved 
using the SKH.QUERY.CTL.STROKE.CDUNL 
SKMUERY.STROKE.LENGTH, and SKN_ 
QUER¥_STROKE_DATA messages. These 
messages can, in turn, allow you 
to store the information to a file. 
You can put stroke information 
back into a buffer to allow sketch 
replay. This can be done by insert¬ 
ing the stroke data into the SKETCH- 
STROKEDEF data structure. You can 
redisplay the stroke information 
stored in this data structure by 
sending the SKM_AOD_STRQKE mes¬ 
sage to the sketch control. This is 
shown in Figure 7. Sending the 
message $KM_OELETEJLL_STROKES to 
the sketch control allows the clear¬ 
ing out of the control's sketched 
contents. By sending the 
SKH.UNDO TASTJTROKE message to the 
sketch control, a user is able to 
undo a stroke within a sketch, 
one stroke after another, until 
nothing is left. You can modify the 
pen's ink color sending the sketch 
control the SK«.$ET.CTl_INK_COLOR 
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HRESULT EXPENTRY SketchDlgProd HHND hwnd, ULONG message, HPARAK mpl, MPARAH mp2 ) 

{ 


switch (message) 

{ 

case WH.INITOLG: 


UinSendHsg(WinVindowFromID(hwnd, ID.SKETCH), SKN_SET_CTL_INK_COLQR, HPFRDHSHORT(CLR.BLUE), OL); 
ReadlndDisplaySketch(hwnd, CardInfo->RecId); 
return (HRESULT)TRUE; 

case WH.CONTROL: 
switch (KXUSHORT(mpl)) 

{ 

// add the stroke to the control's 'data base' 
case SKN.STROKE.ADD: 
return OL; 

// clear entire control 
case SKIt.CONTRQL.CLEARED: 
return OL; 

// undo last stroke 
case SKN.STROKE.UNDO; 
return OL; 

default: 

break; 

> 

return (HRESULT)TRUE ; 

case WH.COHHAND: 
switch (LOUSHORT(mpi)) 

{ 

// the user pressed the clear button 
case ID.CLEAR: 

UinSendHsg(UinUindowFromID(hwnd, ID.SKETCH), SKH.DELETE.ALL.STRDKES, OL, OL); 
break; 

// the user pressed the undo button 
case ID.UNDO: 

HinSendHsgOiinWindowFromID(hwnd, ID.SKETCH), SKK.UNDO.UST.STROKE, OL, OL); 
break; 


break; 



Figure 5. Window procedure that controls aspects of the sketch control 
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USHORT SaveSketchToFile(HWND hwndDlg, CHAR *RetId) 

{ 

PSKETCHSTRDKEDEF pStrokeData = NULL; 

// Get the total count of strokes in the sketch control, 
ulStrokeCount = 

(ULONG) WinSendMsg(WinWindowF™iD( hvndDlg, IDJKETCH), SKH_QUERY_CTL_STROKE_COUNT y 

NULL, NULL); 

// if there is nothing in the sketch control erase the file 
if (ulStrokeCount < 1} { 
unlink(filename); 
return TRUE; 

} 

// Next, Open file to save Application Record, if first time - create it* 

re ^ DosOpen(filename, Ahf, Miction, 0, FILEJORMAL, FILEJ3PEN ! FILE.CREATE, (ULONG)OPENJCCESSJEADWRITE I 

0PEN_5HARE_DENYREADWRXTE | QP£N_FLAGS_FAIL_QN_ERROR, 

(PEA0P2)NULL); 

ulSignatureSize = ulStrokeCount * $izeof{ULONG); 

// Halloc enough to save the lengths of each stroke* 
ulEachStrokeLength = (ULONG *) calloc(ulStrokeCount, sizeof(ULONG)); 

// First stroke to the last stroke - Save each strokes' length in 
// the array which was malloced 

for {ulSavelndex = 0; ulSavelndex < ulStrokeCount; ulSaveIndex++) { 
ulf achStrokeLength[ulSa v elnde x] = 

(ULONG) WinSendMsg(WinWindovFromID( hwndDlg, ID.SKETCH), 

SKM_QUERY_STRDKE_LENGTH, 

// actual stroke number 
NPFRQNLQNG(ulSaveIndex + 1), 

NULL); 

ulSignatureSize += ulEachStrokeLength[ulSavelndex]; 

// Write HEADER containing Stroke count and Sketch size, 

DosWrite(hf, 

AulSignatureSize, 
sizeof(ULONG), 

MBytesWritten); 

DosWrite(hf, 

^ulStrokeCount, 
sizeof(ULONG), 

MBytesWritten); 

// Write ALL of the stroke's lengths to the file, 

DosWrite(hf, ulEachStrokeLength, sizeof(ULONG) * ulStrokeCount, MBytesWritten); 

// First stroke to the last stroke - Write each stroke to the file* 
for (ulSavelndex = 0; ulSavelndex < ulStrokeCount; ulSavelndex++) { 

// Allocate a buffer (non-shared) based on that size, 
pStrokeData = malloc(ulEachStrokeLength[ulSavelndex]); 


Figure & Code that saves sketch strokes to a file (continued on page 70) 
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// Get the Stroke information, 
WinSendMsg(WinWindouFrorfiID{ hundDlg, ID .SKETCH), 
SKH.QUERY_STROKE.DJlT A, 

H PF ROM LON G(ulSa v elnde x + 1), 
// actual stroke number 
HPFROHP(pStrokeData) ); 

// Write the Stroke to file, 

DosWrite(hf, 

pStrokeData, 

ulEachStrokeLength[iilSaveIndex], 
AulBytesWritten); 

free(pStrokeData); 

} 

OosQose(hf); 
free(ulEachStroketength); 
return TRUE; 

} 


Figure 6. Code that saves sketch strokes to a file (continued from page 69} 


VSHORT ReadUndDisplaySketch(HWND hundDlg, CHUR *ReeId) 

{ 

PSKETCHSTROKEDEF pStrokeData = NULL; 


rc 


DosOpen(filename, 
Ahf, 

AulAction, 

0 , 

FILE.NQRHAL, 


FILE.OPEN , (UL0NG)OPEN_ ACCESS. RE A DWRITE 
lOPEN.SHARE.DENYREADWRITE | OPEN.FUGS.FAIL.ON.ERRQR, 
(PEA0P2)MULL) 


DosRead(hf, AulSignatureSize, sizeof(ULONG), AulBytesRead); 
DosRead(hf, AulStrokeCount, sizeof(ULONG), AulBytesRead); 

// Halloc enough to retrieve the lengths of each stroke. 
ulEachStrokeLength = (ULONG *) 
calloc(ulStrokeCount, sizeof(ULONG) ); 

// Read AH stroke lengths into array of lengths. 
DosRead(hf, (VOID *} ulEachStrokeLength, 

(sizeof(ULONG) * ulStrokeCount), AuXSytesRead); 
if ( ulBytesRead != (sizeof(ULONG) * ulStrokeCount) ) { 

DosBeep(500,200); 

DosCLose(hf); 

free(ulEachStrokeLength); 


Figure 7. Code that reads stroke data from a fife and redisplays the strokes in a sketch control (continued on page 71} 
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return(FALSE); 

} 

// First stroke to the last stroke - Read each stroke from the file 
for (ulStrokelndex = 0; ulStrokelndex < ulStrokeCount; ul5trokeIndex++) { 

// Allocate a buffer (non-shared) based on that size* 
pStrokeOata = malloc(iJlEachStrokeLength[ulStrokelndex]); 

memset(pStrokeOata * "\0%ul£achStrokeLength[ulStrokeIndex]}; 

// Read the stroke from the file into the buffer. 

OosReadOif, 

pStrokeOata, 

ulEachStrokeLength [ulStrokelndex], 
ftulBytesRead); 

// The following code is necessary for Stroke Data pointer fix ups after each read. 
pStrokeData->pStroke = (PSTROKEOATA) ( (PBYTE) pStrokeOata + sizeoff SKETCHSTRQKEDEf )); 
pStrokeData->pStroke->pX Y = (PPOINTL)( (PBYTE) pStrokeOata + sizeof( SKETCHSTRQKEDEF ) + 
sizeof( STROKEDATA )); 

if (pStrokeData->p5troke->pAuxInfo) { 

p$trokeData->pStroke->pAuxInfo = (PAUJtDATAINFO) ( (PBYTE) pStrokeData->pStroke->pXY 
+ pStrokeData^>pStroke“>uiNu(nPoints * sizeoff PQINTL )); 

if (pStrokeData->pStroke->pAuxData) { 

pStrokeData->pStroke->pAuxData - (PAUXSTROKEDATA)( (PBYTE) pStrokeData->pStroke->piluxInfo + 
sizeof( AU1DATIINF0 ) 

+ sizeof( AUXDATADESC ) 

* ( pStrokeData fc >pStroke->pAuxInfo->ulNun5ELeEnents - 1 ) + pStrokeData->pStroke->ulNumPoints 
^ * pStrokeData“>pStroke->pAuxInfo->ulAuxSize); 

if ( ulBytesRead !- ulEachStrokeLength[ulStrokelndex]) { 

DosBeep(500,2QQ); 
free(ulEachStrokeLength); 
free(pStrokeOata); 

OosQose(hf); 

return(FALSE); 

// Put the Stroke into the Sketch Control. 

re = (80QL)WinSendHsg( WinWindowFromIO( bwndDlg, IDJKETCH), $KM_AD0_STRQKE t 
NULL, 

MPFROMP(pStrokeData) ); 

} 

free(pStrokeOata); 

} // end for loop - completed reading all strokes 

// Free the array of stroke lengths 
free(ulEachStrokeLength); 

DosQose(hf); 
return TRUE; 


Figure 7. Code that reads stroke data from a fife and redisplays the strokes in a sketch control (continued from page 70) 
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Figure ft The index pegs 

message along with the desired 
ink colon The code in Figure 5 
shows how to use these messages. 

THE INDEX PAGE 

The Index page allows a user to see 
all of the entries in a book at a 
glance. Additional function has 
been added to this page by allow¬ 
ing a user to filter on all of the 
fields displayed for entries in the 
index view. The fields include first 
and last name, company, and state. 
Once a field is chosen, a combed 
handwriting control is displayed, 
allowing the user to hand write in 
the text. This is shown in Figure 8. 

As each character of the text is 
recognized, the Container control 


(list) filters out the entries that do 
not match the filter criteria. At any 
point, a user can tap on a name 
and the book will automatically 
turn to that entry's corresponding 
page. Also notice that the available 
types of communications for each 
entry in the book are indicated by 
the graphics symbol before each 
name. Figure 8 contains an exam¬ 
ple of the index page. 

OTHER TIPS 

Remember not to overdo hand¬ 
writing entry recognition. Gen¬ 
erally, you should support hand¬ 
writing entry but not require it. 
Even though handwriting recog¬ 
nition is an exciting new technol¬ 


ogy, it is still much simpler, 
quicker, and more reliable for a 
user to be able to tap with a pen 
rather than hand write something. 
For example, it is better to create 
a list of selectable items than force 
the user to enter an item. Restrain 
your recognizable set of charac¬ 
ters, if possible. For example, if 
your application is interested 
only in numbers, limit your rec¬ 
ognizable character set to num¬ 
bers. This will improve your 
recognition results. The capability 
to constrain the recognizable 
character set by allowing the pro¬ 
grammer to specify various char¬ 
acter sets or even individual char- 
acters is being considered for 
future releases of Pen for OS/2. 

Future releases of Pen for 
OS/2 may also support handwrit¬ 
ing recognition in single-line 
entry fields and multiline entry 
fields systemwide. In addition, 
ruled and unruled text entry may 
be available. If you know that 
your users will use the applica¬ 
tion with pen only (no keyboard), 
get rid of keyboard- and mouse¬ 
centric constructs such as double 
tapping, mouse button 2 scenar¬ 
ios, the concept of default buttons 
and highlights, pneumatics, and 
so on. Overall navigation should 
be achieved with mere taps of the 
pen. Another natural use of Pen 
Extensions is the enablement of 
allowing users to annotate on top 
of existing electronic documents. 

Also, remember to replace 
key macros with gesture macros. 
Most of all, from the onset of your 
pen-centric application's design, 
remember that the user will now 
be using a pen. It is a new para¬ 
digm; users will want to interact 
differently with your application. 
It should feel more like pen and 
paper. As the user becomes more 
experienced with the pen envi¬ 
ronment, the application's con¬ 
straints of the mouse and key¬ 
board should become less 
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evident. A pen-centric application 
should be designed from the 
ground up for use with pen-based 
computers. The best way to 
achieve a pen and paper-like 
application is to design from the 
outside (look and feel) to the in¬ 
side (code). The interface should 
require minimal computer knowl¬ 
edge on the part of the user. 

Special thanks to Anthony E. 
Martinez for supplying the graph¬ 
ics work and ideas for the user 
interface representation. Also, I 
thank Janice Roberts for giving me 
the opportunity to create this 
application and her ideas for the 
index page. 

Sarka J. Martinez, joined IBM in 1988 
and is a senior associate programmer in 
the mobile applications software arm of 
the Mobile Pen and Speech (MVP) team in 
Boca Raton, FLa., which is part of the PSP 
division. Over the years, Martinez has 
worked on various advanced technology 
projects and is now involved in designing 
and implementing applications for IBM's 
PDA software solution. She received a B.S. 
in computer science at the State Uni¬ 
versity of New York at Buffalo. Martinez 
has also received several patents for 
graphical user interface techniques. 
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Buyer's Guide 


The staff of OS/2 Developer put together this special section to guide you through the various 
compilers and interpreters available for OS/2. The products described in this guide are based on surveys 
sent to vendors; they are provided as a service to you and are free to vendors. These listings do not rep¬ 
resent an endorsement by OS/2 Developer. Although every effort has been made to ensure accuracy, we 
do not assume any responsibility for error or omission in this section. Please contact the companies 
directly for more information. 


Compilers and Interpreters 
Buyer's Guide 


ACUCOBOL INC. Circle No. 101 

Acucobol-85 2.1.1 for OS/2 2.0 and 
Acucobol-85 2.1.2 for OS/2 1.3 compilers 
offer machine-independent code that is 
portable, without recompiling, across dif¬ 
ferent platforms, including AIX, AOS, MS- 
DOS, NetBIOS, OS/2, Ultrix, UNIX, 
XENIX, and VMS operating systems. The 
compilers include extensions for boxed 
and reverse video windows; pop-up win¬ 
dows; color; scrolling; machine-indepen¬ 
dent handling of file and directory names; 
file, record, and device locking; index file 
compression and encryption; system and 
terminal information; delete file; and read¬ 
ing of locked records. Acubol-85 also 
incorporates screen section support, DG- 
ICOBOL compatibility, a user-replaceable 
file system, and hot keys. Price: Please 
contact vendor. 

Acucobol Inc., 7950 Silverton Ave., 
Ste. 201, San Diego, Calif. 92126, (800) 262- 
6585 or (619) 689-7220, fax (619) 689-7251. 

ARITYCORP. Circle No. 102 

Arity/Prolog32 1.0 provides floating-point 
arithmetic, a menu-driven/windowed 
programming environment, a built-in edi¬ 
tor, text string support, definite clause 
grammar support, and embedded inter¬ 
face to other programming languages. It 
provides support for concurrent Prolog 
execution, including a virtual database 
that supports two gigabytes of memory 


and provides sequential, hashed, and b- 
tree indexing. It supports Microsoft 
Languages, Lattic C, and Assembly. 
Arity/Prolog32 contains a C compiler 
capable of handling C declarations and C 
expressions embedded with Prolog source 
code. The user can call C or Pascal func¬ 
tions from inside Prolog. The user can also 
call Prolog from C and Pascal and inter¬ 
face with dynamically linkable libraries. 
Price: $2,450.(X). 

Arity Corp., Damonmill Sq., Concord, 
Mass. 01742, (800) 369-5622 or (508) 371- 
1243, fax (508) 371-1487. 

BORLAND 

INTERNA TIONAL Circle No. 103 

Borland C++ 1.5 for OS/2 includes tem¬ 
plates, exception handling, run-time type 
information, and ANSI string classes. It 
takes advantage of OS/2's multithreaded, 
multitasking environment and includes 
32-bit optimizations and a Presentation 
Manager-hosted integrated device elec¬ 
tronics. Other features include Borland 
BPMCC (custom controls) and Borland's 
ObjectBrowser for graphically displaying 
class hierarchy. Borland C++ for OS/2 
also includes a free copy of Borland Turbo 
Assembler. Price: $199.95; $79.95, upgrade. 

Borland International, 100 Borland 
Wy., Scott Valley, Calif. 95066-3249, 
(800) 331-0877 or (408) 431-1000, fax 
(408) 431-9119. 


74 


OS/2 DEVELOPER 











CABOT SOFTWARE LTD. Circle No. 104 

UCSD Pascal Compiler is integrated with 
Presentation Manager, allowing full 
Presentation Manager applications in 
Pascal. It is also integrated with the Power 
System development environment, which 
includes a set of programming tools and 
facilities: command menu with window¬ 
ing and pop-up and pull-down menus; 
test and program editor; print utility to 
allow control of headers, pagination, for¬ 
mat, spacing, and paper; library manager 
to add or remove generic code segments 
from code library; and file transfer. 
Applications generated by the Power 
System are stored in P-Code, a machine- 
independent programming standard that 
supports compact code files that can be 
smaller than the source text file. Price: 
$299.00 

Cabot Software Ltd. The Vicarage, 
Stoke View Rd., Bristol, ILK, +44-272- 
586644, fax +44-272-586680. 

CALIFORNIA SOFTWARE 
PRODUCTS INC Circle No. 105 

BABY/4XX 1 .5 enables the user to downsize 
AS/400 native code from a midrange sys¬ 
tem to the PC where it can be recompiled 
and used on a network or in multiuser or 
single-user mode. Running under OS/2, 
BABY/4XX allows the user to integrate 
AS/400 applications with DOS, Windows, 
and OS/2 software, such as word proces¬ 
sors, spreadsheets, and databases. When 
used in conjunction with Novell NetWare, 
BABY/4XX provides client/server capa¬ 
bility. Price: $3,500,00. 

BABY/AS 4.0 development systems 
permit the development and execution of 
IBM System/36 and AS/400 PRG II appli¬ 
cations on IBM-compatible PCs. Running 
under OS/2, BABY/AS allows the user to 
integrate RGP II applications with DOS, 
Windows, and OS/2 software. BABY/AS 
can be used on a network or in multiuser 
or single-user mode. Price: $3,500.00. 

California Software Products Inc,, 525 
N. Cabrillo Park Dr., Santa Ana, Calif. 
92701-5017, (800) 841-1532 or (714) 973- 
0440, fax (714) 558-9341. 


CATSPAWINC. Circle No 106 

SPITB0L-386 1.28 is an implementation of 
the SNOBOL4 programming language. It 
features a vocabulary of string manipula¬ 
tion primitives for pattern matching and 
text analysis. Applications include conver¬ 
sion; reformatting; analysis of text; litera¬ 
ture and music analysts; and program pro¬ 
totyping. Price: $295.00. 

Catspaw Inc., P.O. Box 1123, Salida, 
Colo. 81201, (719) 539-3884, fax (719) 
539-4830. 

COMPUTER ASSOCIATES 
INTERNA TIONAL INC. Circle No. 10? 

CA-REAUZER 2.0A is a visual development 
tool that enables the development of eross- 
platform applications for individual, 
workgroup, and company-wide needs. 
This BASIC Construction Set is available 
on any system compatible with OS/2 2,1 
or higher as well as Windows 3.1* CA- 
REALIZER helps the user create spread¬ 
sheets, charts, text editors, animation, 
graphics tablets, and forms from tools. 
Price: $99.00. 

Computer Associates International 
Inc., One Computer Associates Plaza, 
Islandia, N.Y, 11788-7000, (800) 225-5224 
or (516) 342-5224, fax (516) 342-5734. 

DATA ACCESS CORP. Circle No. 108 

Dataplex 3.05 for OS/2 2.1 is an application 
development environment that includes a 
relational DBMS and an object-oriented, 
procedural fourth-generation language. 
This 32-bit character-cell tool allows users 
to share files with DataFlex for DOS or 
Windows users and interface with the 
DataFlex server. Price: $795.00, single-user 
development; $995.00+, multiuser. 

Data Access Carp., 14000 SW 119th 
Ave., Miami, Fla. 33186, (800) 451-3539 or 
(305) 238-0012, fax (305) 238-0017. 

DIGITALK Circle No. 109 

PARTS Workbench 2.0 for OS/2 is a client/ 
server integration tool that enables appli¬ 
cation development through assembly and 
reuse of application components. The 
Workbench comes with over 65 prebuilt 



components, both visual and nonvi¬ 
sual. The user can write other com¬ 
ponents in Smalltalk/V, C, COBOL, 
or other languages. Price: $1,995.00. 

Smailtalk/V 2.0 for OS/2 is a 32* 


bit, object-oriented development 
environment for OS/2. It contains a 
set of tools for developing graphical, 
portable, CUA-compliant applica¬ 
tions. Smailtalk/V includes a re¬ 
usable class library, a push-button 
debugger, browsers, inspectors, and 
an incremental compiler. Price: 
$995.00. 


Digitalk, 5 Hutton Centre Dr., 
Santa Ana, Calif. 92707, (800) 922- 
8255 or (714) 513-3000, fax (714) 
513-3100, 


EDV— 

KOHLENBACH Circle No. 110 

KIM 2.0 is a database developing sys¬ 
tem with a BASIC-like programming 
language and a dBase-compatible 
database engine. A free license run¬ 
time kit is available. KIM enables 
users to build OS/2 Presentation 
Manager programs. Price: $150.00. 

EDV Buero Kohlenbach Soft- 
ware-Entwicklung, 8502 Winters- 
dorf, Blumenstr. 58e, Germany - 
90547 Stein, +49-911-688-9040-1, fax 
+49 9183-242. 

GLANCE AG Circle No. W 

Modula-2 to C Translator type M2CC 4.5 

is a compiler system that translates 
Modula-2 applications into C. It 
enables the user to transfer Modula- 
2 programs from a VAX /VMS sys¬ 
tem to a DEC/Alpha machine, for 
example. The M2CC/C Modula-2 to 
C Translator also supports other sys¬ 
tems with a C development environ¬ 
ment, such as DOS, OS/2, and UNIX 
systems. The translator is also suit¬ 
able for new and cross development 
of Modula-2 applications. Price: 
$2,250.00; $6,700.00 for workstations. 

Glance AG, Gewerbestrasse 4, 
CH-8162 Steinmaur, Switzerland, +41 
(1) 853-39-49, fax +41 (1) 853-08-09. 

GPF SYSTEMS INC Circle No. 112 
GpfRexx provides WYSISYG, visual, 
OS/2 Presentation Manager pro¬ 


gramming with REXX. It allows the 
user to point and click to create 
CUA'91 applications. The Gpf 
Interface Builder handles the logic 
for managing events, windows, con¬ 
trols and their data, and for display¬ 
ing help. Other features include mul¬ 
timedia, drag/drop, multitasking, 
SQL (DB2/2), and communications 
(APPC, CPI-C, EHLLAPI). No royal¬ 
ties. Price: Please contact vendor. 

Professional Developer's Toolkit 
provides support for OS/2 2,x, OS/2 
1.3.x, and Windows 3.0 and 3.1. ft 
allows the user to point and click to 
create CUA'91-compliant GUIs. It 
generates C or C++ source, help 
source, and ancillary files. GpfToois 
enables manipulation and automatic 
documentation of Gpf designs. Price: 
$1,440.00. 

Gpf Systems Inc., 30 Falls Rd., 
PO. Box 414, Mood us. Conn, 06469, 
(800) 831-0017 or (203) 873-3300, fax 
(203) 831-3302. 

HOCKWARE INC Circle No. 113 

VisPro/REXX 2 0 uses OS/2, 
Workplace Shell, and the REXX lan¬ 
guage as a visual programming 
environment. It provides the user 
with a development environment for 
creating, testing, debugging, modify¬ 
ing, and distributing OS/2 2.x GUI 
programs. VisPro/REXX is royalty- 
free. Price: $99.00 to $299.00+, 

Hock ware Inc., 315 N, Academy 
St, Ste. 100, Cary, N.C. 27515, (919) 
380-0616, fax (919) 380-0757. 

IBM Circle No. 114 

APL2 for OS/2 Entry Edition 10 is a pro¬ 
gramming language for application 
program developers and interactive 
users. It can be used to develop both 
commercial and scientific applica¬ 
tions, "what-if" modeling, explor¬ 
atory programming, interactive com¬ 
puting, decision support, and data 
analysis. It includes a Presentation 
Manager interface, graphics facili¬ 
ties, calls to other languages, and 
large work spaces, APL2 for OS/2 is 
compatible with the APL2 family of 
products, which run on IBM 
System/370 and System/390 with 


CMS or ISO, the IBM RISC 
System/6000 with AIX/6000, the 
Sun SPARCstation with Solaris, and 
all personal computers with DOS. 
Part #89G1556. Price: $185.00. 

APL2 for OS/2 Advanced Edition is 
a programming language for appli¬ 
cation program developers and 
interactive users. It can be used to 
develop both commercial and scien¬ 
tific applications, "what-if" model¬ 
ing, exploratory programming, inter¬ 
active computing, decision support, 
and data analysis. It includes all of 
the features of the Entry Edition plus 
relational database access, tools for 
writing auxiliary processors, a per¬ 
formance monitor, and the ability to 
distribute data and processing 
among multiple APL2 systems con¬ 
nected through TCP/IP. APL2 for 
OS/2 is compatible with the APL2 
family of products, which run on 
IBM System/370 and System/390 
with CMS or TSG, the IBM RISC 
System/6000 with AIX/6000, the 
Sun SPARCstation with Solaris, and 
all personal computers with DOS. 
Part # 89G1697. Price: $650.00. 

PL/I for OS/2 1.1 Professional 
Edition is an Operating System/2* 
(OS/2 4 ) Version 2 based PL/I appli¬ 
cation development environment. It 
is designed for the experienced PL/I 
application developer who wants to 
have the power of the host language 
combined with the productivity of 
the PC tools. This compiler gives the 
PL/1 application programmer the 
capability to write "client/server" 
applications in PL/1 that access data 
on MVS, VM, AIX/6000, and OS/2. 
It is integrated with the DB2 family 
of products, with IMS Client 
Server/2, and with IBM's CICS fam¬ 
ily of products. The Toolkit—a sepa¬ 
rately priced feature—provides a set 
of valuable tools for visual building 
of screens for Presentation Manager. 
Part #10H7848. Price: $750 (must 
order on or before Sept. 30, 1994, to 
receive this price). 

PL/1 for OS/2 1.1 Personal Edition is 
a full function Operating System/2* 
(OS/2*) Version 2 based PL/1 appli¬ 
cation development environment. It 
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is designed for the PL/I application 
developer who wants to have the 
power of PL/1 language available on 
a standalone PC or a small LAN. 

IBM PL/I for OS/2 Personal 
Edition is ideal for programmers 
writing new PL/1 applications that 
do not require access to mainframe 
data. Its applications can call Pre¬ 
sentation Manager APIs, C-based 
applications or tools, and applica¬ 
tions or tools written in REXX, The 
Toolkit—a separately priced fea¬ 
ture—provides tools for visual 
building of screens for Presentation 
Manager. Part #10H7819. Price: 
$299.00, Toolkit (part #1322966) is 
$199.00. 

IBM, 555 Bailey Ave., San Jose, 
Calif. 95141, (800) 426-2255, sales 
(408) 463-4871, technical (408) 463- 
4363, fax (408) 463-4820. 


LESTEC PTY. LTD. Circle No . 115 

Modular And Integrated Design (MAID) 

tJ is an interface designer that helps 
the user create a repository of inte¬ 
grated working objects containing 
REXX event scripts. Features 
include multithreaded support; 
interdialog communication; a suite 
of subcommands and functions; and 
an external REXX and C interface. 
MAID provides support for data¬ 
base and host communications. 
Price: $199.00. 

Lestec Pty. Ltd., P.GX Box 1394, 
Dee Why, NSW 2099, Australia, +61 
(2) 981-5925, fax +61 {2} 981-5925. 

META WARE Circle No. 116 

High C/C++ 3.2 for OS/2 is a 
"DireetToSOM" compiler. It enables 
the user to compile large programs 
and generate code. It is ANSI-com¬ 


patible and provides support for 
C++ templates and exceptions. High 
C/C++ includes IBM's OS/2 
Developer's Toolkit and DLL's to 
link into the WorkFrame/2 inte¬ 
grated environment, MetaWare 
offers free technical support and a 
money-back guarantee. Price: 
$595.00; $495.00, if user of another 
MetaWare compiler, 

MetaWare, 2161 Delaware Ave„ 
Santa Cruz, Calif. 95060, (408) 429- 
6382, fax (408) 429-9273. 



MICRO DATA BASE 

SYSTEMS INC. Circle No . 117 

Object/1 3.0 is an object-oriented 
graphical development environ¬ 
ment. Features include windows 
painter, source code management, 
and debugging tools. Price: 
$4,000.00. 


Read and Write dBASE files 
from C, C++, and now REXX! 


dbfLIB 



Programmer's Library 

. for OS/2 

dbfREXX 


dbfREXX allows reading 
and writing dBASE flies 
from your OS/2 REXX 
programs! 

dbfUB includes support 
for DOS, Windows, 

OS/2 and Windows NT 
all in one package! 



Sales (405) 360-3045 

Tech Support (713)537-0318 
Visa and MasterCard accepted. 



dSOrr Development Inc. 
4710 Innsbnjk Drive 
Houston. TX 7706& 


ASIAN OS/2 

DEVELOPER SUPPORT 



Get help porting OS/2 applications for 
Japanese, Chinese, or Korean. 

Experienced guidance from the leading 
double byte character set OS/2 developer. 
Training or consulting on either an hourly or 
long term basis. 



MicroBurst, Inc. 


9035 Shady Grove Court 
Gaithersburg, MD 2087/ 


(301) 330-2995 

Fax:(301) 330-8609 
CompuServe: 70334.3616 
Internet: 70334 3616 @ 
COMPUSERVE.COM. 
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GURU 3.1 is a development envi¬ 
ronment and relational database 
management system that offers 
information-processing tools. 
Within GURU, the user can access 
features such as a spreadsheet, busi¬ 
ness graphics, text processing, report 
generation, communications, and a 
language interface. GURU is com¬ 
patible with SQL. It supports for¬ 
ward chaining, backward chaining, 
mixed chaining, multivalue vari¬ 
ables, and fuzzy reasoning. Price: 
$7,000.00. 

Knowledge Man 3.1 combines a 
relational database management sys¬ 
tem and a fourth-generation lan¬ 
guage with a set of decision support 
tools. It includes KGL, an object- 
based, fourth-generation language 
and a KGL compiler. Binary large 
objects enable the user to store dif¬ 
ferent types of information, includ¬ 
ing sounds and images, in variable- 
length records that the user can 
access with SQL queries. Price: 
$1,500.00. 


Micro Data Base Systems Inc., 
1305 Cumberland Ave., P.O. Box 
2438, West Lafayette, Ind. 47906, 
(800) 445-6327 or (317) 463-7200, fax 
(317) 463-1234. 


MICRO FOCUS Circle No. 118 

Micro Focus COBOL 3.2 contains a PC 
COBOL compiler and an interactive 
code debugger (Animator). Micro 
Focus has added 75 enhancements to 
this updated version, ranging from 
new syntax and increased perfor¬ 
mance to improved run-time man¬ 
agement and usability enhance¬ 
ments. Price: $750.00. 

Micro Focus COBOL Workbench 3.2 
is a suite of programmer productiv¬ 
ity tools that allows the user to 
develop and maintain applications. 
Micro Focus COBOL Workbench 
includes Micro Focus COBOL 
Compiler, Micro Focus Toolset, and 
Micro Focus Operating System 
Extensions (OSX). Price: $2,500.00. 


Micro Focus, 2465 E. Bay Shore 
Rd., Palo Alto, Calif. 94303, (800) 
872-6265 or (415) 856-4161, fax (415) 
856-6134. 

MICROWA Y INC. Circle No. 119 

NDP Pascal 4.4 for OS/2 implements 
the ANSI/IEEE standard 770X3.97- 
1983, a superset of Niklaus Wirth's 
Pascal. It includes several extensions 
from Berkeley 4.2 BSD Pascal and 
the British Standards Institute Level 
0, a preprocessor, separate compila¬ 
tion of modules, and interfaces to 
the Microway C library. Price: 
$595.00. 

NDP C/C++ 4.4 for OS/2 is an 
AT&T 2.1-compatible compiler that 
includes NDP C, a dual-dialect com¬ 
piler that supports two UNIX 
dialects (BSD 4.2 and AT&T 2.1), and 
the new ANSI C specifications. It 
features a function inliner, classes, 
single and multiple inheritance, con¬ 
structors and destructors, and func¬ 
tions and operator overloading. 
Price: $595. 

NDP Fortran 4.4 for OS/2 offers 
standard global optimizations per¬ 
formed by a number of C compilers. 
It provides coprocessor support for 
the Weitek 3167/4167 and the Intel 
i860 and optimizations for the 
Pentium and 387/487 relating to 
storage allocation and inline execu¬ 
tion of intrinsic functions. NDP 
Fortran is an F77 with VMS, VS, and 
MS extensions. It is compatible with 
the IBM C Set compiler. Toolkit, and 
WorkFrame. Price: $595.00. 

Microway Inc., Research Park, 
Box 79, Kingston, Mass. 02364, (508) 
746-7341, fax (508) 746-4678. 

PARCPLACE 

SYSTEMS INC. Circle No. 120 

ObjectWorks Smalltalk is an object- 
oriented development environment 
for the development and delivery of 
color graphic applications in a het¬ 
erogeneous computing environment. 
ObjectWorks includes Smalltalk lan¬ 


guage, a set of integrated designed- 
for-objects development tools and a 
mature class library of over 400 
types of portable objects. Price: 
$2,495.00. 

ParcPlace Systems, Inc. 99 E. 
Argues Ave., Sunnyvale, Calif., 
94086, (408) 481-9090,' fax (408) 481- 
9095. 

PROMULA DEVELOPMENT 
CORP. Circle No. 121 

Promula Fortran to Fortran Translator 
5.02 transforms unstructured 
spaghetti Fortran code into well- 
structured Fortran code. It aids in 
cleaning up and upgrading old 
Fortran code. The translator sup¬ 
ports most known Fortran dialects- 
standard or extended-including 
most Fortran 90 features. Price: 
$1,500. 

Promula Fortran to C Translator 

5.02 is a portation tool that converts 
Fortran source code to C source 
code. It supports the Fortran 66 and 
Fortran 77 standards and many 
extended dialects (VAX, IBM, 
PRIME, SUN FORTRAN, and so on), 
including most Fortran 90 features. 
The C code it produces is portable 
and readable (maintainable). Price: 
$1,500.00. 

Promula Fortran to C++ Translator 

5.02 converts FORTRAN code to C++ 
code. It supports standard Fortran 
66, Fortran 77 and many extended 
dialects (VAX, SUN, PRIME, IBM 
VS), and most Fortran features. It 
produces C++ code that is readable 
and integrates with contemporary 
C++ OS/2 platforms—IBM C Set, 
Borland, Watcom, MetaWare, and 
Zortech. Price: $1,500.00. 

Promula Fortran Compiler 5.02 sup¬ 
ports the Fortran 66 and Fortran 77 
standards and many extended 
dialects (VAX, IBM, PRIME, SUN 
FORTRAN, and so on), including 
most Fortran 90 features. It compiles 
Fortran to C and is integrated with 
several OS/2 C/C++ compilers— 
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Watcom, Borland, Zortech, Meta- 
Ware, and IBM C Set. Price: $1,000,00. 

Promula Development Corp., 
3620 N. High St., Ste. 301, Columbus, 
Ohio 43214, (614) 263-5454, fax (614) 
263-5573. 

QUERCUS 

SYSTEMS Circle No. 122 

Personal REXX 3.0 for OS/2 augments 
OS/2 REXX by including Quercus 
Systems' REXXLIB extensions for 
array handling, mathematical func- 
tions, interprocess communication, 
and general system services. In addi¬ 
tion, it provides global variables; 
utilities for VM/CMS and VMS/ 
TSO compatibility; and external data 
queue support. A variety of perfor¬ 
mance enhancements improve Per¬ 
sonal REXX's speed. Price: $175.00, 

Quercus Systems, P.O, Box 2157, 
Saratoga, Calif. 95070, (408) 867- 
7399, fax (408) 867-7489. 

REUSABLE 

SOLUTIONS INC. Circle No. 123 

Facets/4GL 3M is an object-oriented, 
fourth-generation language. This 
library of classes adds a collection of 
design tools to the Object- 
works/Smalltalk development sys¬ 
tem, Through a series of on-screen 
forms, FACETS allows the user to 
generate screens, reports, menus, 
and other interface components, 
FACETS/4GL consists of five design 
tools: a schema designer, a forms 
designer, a report writer, a menu 
builder, and a help author. Price: 
$ 2 , 000 . 00 . 

Reusable Solutions fnc., 1130 
SW Morrison, #318, Portland, Oreg. 
97205, (503) 223-6892, fax (503) 223- 
4498. 

SCIENCIA LTD . Circle No. 124 

Procyon Common Lisp 3 3 4 is an object- 
oriented development environment 
based upon Common Lisp and 
CLQS. Users can port applications 
to OS/2, Windows, and Macintosh 


without code changes. Procyon is 
royalty-free. Price: $1,800.00. 

Scientia Ltd., St. John's 
Innovation Centre, Cowley Rd,, 
Cambridge U.K., +44-223-42128, fax 
+44-223-42128. 

TOWER TECHNOLOGY 
CORP Circle No , f/5 

TowerEiffel 1.3 is an object-oriented 
programming system that includes 
an Eiffel 3 compiler, a development 
environment, programming tools, 
and a set of reusable software com¬ 
ponents. The TowerEiffel compiler 
provides support for multilanguage 
development and interoperability 
between Eiffel, C, and C++. Price: 
$1,295.00 for commercial license; 
$295.00 for students. 

Tower Technology Corp., 1501 
Koenig Ln., Austin, Tex. 78756, (800) 
285-5124 or (512) 452-9455, fax (512) 
452-1721. 

2500AD 

SOFTWARE INC Circle No. 128 

2500AD C Compiler has floating-point 
math, inline assembly language, 
ROM-able code, and memory bank¬ 
switching. The C Compiler includes 
an assembler, linker, librarian, macro 
preprocessor, simulator/debugger 
(if available), and object libraries. 
Full technical support and a 90-day 
money-back guarantee are included 
in the purchase price. Price: $650.00, 
most versions. 

2500AD Software Inc., 109 
Brookdale Ave., Buena Vista, Colo. 
81211, (800) 843-8144 or (719) 395- 
8683, fax (719) 395-8206. 

VZCQRP. Circle No. 127 

VZ Programmer 2.3 is a programming 
environment that extends the func¬ 
tion of the application by adding 
C++ code to any object in an object- 
oriented environment. This is a non- 
limiting programming environment 
that allows the programming of any¬ 
thing that can normally be pro¬ 


grammed using C++. Price: $2,000.00. 

VZ Corp., 175 S. Main St., Ste. 
700, Salt Lake City, Utah 84111, (800) 
377-1090, (801) 595-1352, fax (801) 
328-4404. 

WA TCOM INTERNA TIONAL 

CORP. Circle No. 128 

Watcom C/C++ 18.0 is a C and C++ 

development system for DOS, 
Windows NT, Win32, OS/2 2.x, 
Novell NLS, and 16-bit DOS and 
Windows 3.x. It combines a compiler 
technology with a development 
environment and set of tools. Wat¬ 
com C/C++ includes a GUI debug¬ 
ger, a C++ class browser, and a pro¬ 
filer. It provides support for C+ + 
templates, exception handling, and 
Microsoft Foundation Class libraries. 
Price: Please contact vendor. 

Watcom International Corp., 415 
Phillip St, Waterloo, Ont. N2L 3X2, 
Canada, (800) 265-4555 or (519) 747- 
4971, fax (519) 747-4971. 

XVT 

SOFTWARE INC Circle No. 129 

XVT Development Solution for C (DSC) 

4,0 pairs XVT-Design, a visual GUI 
layout, prototyping and code-gener¬ 
ation tool, with the XVT Portability 
Toolkit, a thin-layered API that pro¬ 
vides native look-and-feel and sin¬ 
gle-source portability to seven differ¬ 
ent GUIs and over 30 hardware 
platforms. Price: $1,950,00-$6,300.00. 

XVT Development Solution for C++ 
(DSC++) 2.8 features XVT-Power++, 
an applications framework with fea¬ 
tures such as field validation, drag- 
and-drop, environment inheritance, 
nested views, geometry manage¬ 
ment, imaging, and the Rogue Wave 
data structures. Combined with the 
XVT Portability Toolkit, XVT- 
Power++ offers portability to many 
GUIs. Price: $1,950.00-$6,300.OO. 

XVT Software Inc., 4900 Pearl 
E. Cr., Boulder, Colo. 80301, (800) 
678-7988 or (303) 443-4223, fax (303) 
443-0969. 


IPI 


JULY/AUGUST 13 9 4 


79 


ADVERTISER INDEX 


m BOMB OS/2 


for Developers... 
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/ORKPLACC SHELL 
PROGRAMMING 

MnoHarayi 


OS/2 2.1 WORKPLACE 
SHELL PROGRAMMING 

Steve Maruzzi 

**If C++ and Work-place Shell are in your 
career path, this book/software package 
should be in your hands.”— OS/2 Professional 

Packed with high-end tips and techniqueSj 
OS/2 2J W orkplace Shell Programming 
offers a programmer’s insight into OS/2 
application development and shows C programmers how to imple¬ 
ment a full OS/2 interface. A leading authority' on OS/2, Maruzzi 
guides you through the process of building outstanding applications 
and interfaces with examples throughout the text and source code 
supplied on the accompanying disk. You’ll get the low down on ■ the 
OS/2 system architecture • memory management * the graphics 
display interface * and much more. $44, 744 pages t 0-679-79162-0 



for Novices... 



VAN WOLVERTON’S GUIDE 
TO OS/2, VERSION 2.1 

Van Wolverton and Jim Meade 

A critically acclaimed handbook and 
indispensable guide to OS/2 for begin¬ 
ners as well as for intermediate users 
who want to explore its latest features. Perfect for anyone who 
needs ■ straightforward, nontechnical explanations * a concise 
guide to OS/2 basics ■ and quick steps for running multiple appli¬ 
cations. $16, 144 pages , 0-679-74877-6 


and Everyone in Between 


DVORAK'S GUIDE TO 
OS/2, VERSION 2T 

John C. Dvorak, David B. Whittle, 
and Matin McElroy 

“A serious, detailed, dedicated study of 
OS/2 by authors who know' the deepest 
secrets of a massive and powerful operating 
system."—PC Magazine 

Dvorak's Guide to OS/2 , Version 2.1 is a 
complete command reference that thoroughly explains all OS/2 
commands. An extensive tips and tricks section will turn you into a 
power user. The authors provide important resources to help you 
solve any problem, plus a complete listing of worldwide OS/2 
computerized bulletin hoards. $45, 816pages, 0-679-74648-X 
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CLIENT/SERVER SURVIVAL GUIDE HTTH 
OS/2 2.1 by Robert Orfali and Dan Harkey. 

A sweeping tour of client/server systems and 
software. $89.95 0-442-01798-7 IBM# SR28-5494 

CLIENT/SERVER PROGRAMMING WITH 
OS/2 2.1 , 3rd Ed , by Robert Orfali and 
Daniel Harkey. "Absolutely one of the most 
impressive, useful, best-written computer 
books I've ever seen. n -Will Zachman. 

$39.95 0-442-01883-9 IBM # G325D650D2 

THE GUl-OOUI WAR: Windows vs. OS/2 

by Theo S. Mandel. “A book that should be 
forced on every Windows and OS/2 developer 
working today. An exceptionally clear, read¬ 
able guide. If you want to make a good 
program great, there’s no better starting 
place. - OS/2 Professional 
$29.95 0-442-01750-2 IBM# SR28-5251 

OS/2 FUNCTIONS QUICK REFERENCE 
LIBRARY I: Win Functions by Nora 
Scholin. $19,950-442-01897-5 

C AND C++ PROGRAMMING IN THE OS/2 
ENVIRONMENT by Mitra Gopaul. $39.95 
0-442-01240-3 IBM# SR28-4404 

OS/22.1 APPLICATION PROGRAMMERS 
GUIDE by Jody Kelly, Craig Swearingen, 
Dawn Bezviner and Theodore Shrader. 

$34.95 0-442-01786-7 IBM# SR28-5449 

OSK 2.1 REXX HANDBOOK: Basics, 
Applications, and Tips by Hallet German. 

A great reference book that contains info 
not found in any other REXX books. 

$29.95 0-442-01734-0 IBM# SR-5250 


THE OS/2 2.1 CORPORATE PROGRAM¬ 
MERS HANDBOOK by Nora Scholin, Mark 
Sullivan, and Robin Scragg. U A solid job. 
Introduces readers to programming terms 
and concepts. Explanations are lucid and 
reading relevant sections provides you with 
the basics you need. - OS/2 Professional. 
Includes disk. $39.95 0-442-01598-4 
IBM# SR28-4390 

WRITING OS/2 2.1 DEVICE DRIVERS IN C f 
2nd Ed., by Steven Mastrianni "Should give 
any C programmer with a vague knowledge 
of OS/2 and PC hardware a headstart in writ¬ 
ing OS/2 device drivers in C. -International 
OS/2 User Group Magazine. Includes disk. 
$39.95 0-442-01729-4 IBM# SR28-4392 

THE SHELL COLLECTION: OS/2 2JC 
Utilities by Steven Levenson. A great source 
of shortcuts, tips and productivity boosters 
for Windows and DOS. Includes disk. 

$29.95 0-442-01585-2 IBM# G362-0049 

USING WORKPLACE OS/2: Power User’s 
Guide to IBM OS/2 Version 2.1 by Lori 
Brown and Jeff Howard. The authors are the 
principal designers of the Workplace Shell! 
Includes disk. $24.95 0-442-01590-9 
IBM# SR28-4391 

THE OS/2 2.0 HANDBOOK: Applications, 
Integration , and Optimization by William 
H. Zack. “Should be within fingertip reach of 
anyone working with OS/2. IBM would do 
well to include a copy in every package of 
OStf. ’’-OS/2 Professional $34.95 0-442-01234-9 
IBM# G362-0009 

OS#® u H rrgutered trademark of the IBM Corporation 


OS/2 2JC NOTEBOOK: The Best of IBM 
OS/2 Developer edited by Dick Conklin. 
$36.95 0-442-01522-4 IBM# G362-0015 

NOW THAT I HAVE OS/2 2.1 ONW 
COMPUTER, WHAT DO I DO NEXT?, 2/E. 

by Steven Levenson. "Easy to read, loaded 
unth examples, a friendly reference source. ” 
-Journal of The Chicago Computing Society. 
$22.95 0-442-01832-0 IBM# G362-0008-01 

COMPREHENSIVE DATABASE PERFOR¬ 
MANCE FOR OS/2 2.0’s Extended Services 

by Bruce Tate, Tim Malkemus and Terry 
Gray. $41.95 0442-01325-6 IBM# G362-0019 

LEARNING TO PROGRAM OS/2 2.0 
PRESENTATION MANAGER BY EXAMPLE: 
Putting the Pieces Together 

by Stephen Knight, Includes disk. 

$41.95 0442-01292-6 IBM# G362-00U 

THE COBOL PRESENTATION MANAGER 
PROGRAMMING GUIDE by David M. Dill. 
$41.95 0442-012934 IBM# G362-0010 

OS/2 PRESENTATION MANAGER GPI 
GRAPHICS by Graham C. E. Winn $42.95 
0442-00789-6 IBM# G362-0005 


Order directly from 
the publisher by call¬ 
ing 1-800-544-0550. 

To order from IBM 
call 1-800-568-2694 


Van Nostrand Reinhold 

115 Fifth Avenue, New York, New York 10003 
1-800-544-0650 73373.64 @compuserve.com 
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New Tools for OS/2 


TOOLS 

Techbridge Builder, This GUI, 
client/server/ object-oriented ap¬ 
plication development environment for the 
IBM OS/2 operating system allows anyone, 
from experienced users to professional devel¬ 
opers, to create sophisticated workplace 
applications involving drag-and-drop opera¬ 
tions and enterprise-wide database access in 
object-oriented manner. Developers using 
TechBridge Builder simply paint the majority 
of an application into existence with visual 
programming tools and code the rest in stan¬ 
dard COBOL or SQL 

For the advanced developer. Tech Bridge 
Builder provides object-oriented extensions 
to the COBOL language support. 

TechBridge Technology Corp. 

Phone; (416) 222-8998, Fax (416) 222-0168 

XDB-Server 4.0. XDB-Server 4,0 provides 
enhanced server functionality for distributed 
client/server environments through a rich set 
of development tools, including optimized 
query performance, server-to-server connec¬ 
tivity, and administration tools. XDB-Server 
4.0 achieves faster response times through 
performance-tuning options, allowing the 
user to fine-tune the database server. Users 
also have the flexibility of remotely accessing 
data while not robbing the enterprise of con¬ 
sistent system administration. Database 
administrators and developers familiar with 
DB2 3.1 can develop and target applications 
on a client/server LAN using XDB-Server 4,0. 
Of particular note to OS/2 users, XDB-Server 
4.0 has a 32-bit, multithreaded architecture. 



XDB Systems Inc. 

Phone; (301) 317-6800 ext. 146, 

Fax; (301)317-7701 

dbfREXX 1.0. This DLL for OS/2 2.1 extends 
the built-in REXX language with commands 
for manipulating dBase files, including DBF, 
DBT, and NDX. According to the company, 
REXX users will be able to tap into simple 
database management without all the over¬ 
head of a full-blown client/server DBMS, 

dSOFT Development Inc. 

Phone: (405) 360-3045 or (713) 537-0318 

Watcom SQL . Watcom SQL network servers 
for OS/2, which are available in single-user 
and multiuser versions, benefit from the 
advantages of the 32-bit OS/2 platform and 
exploit multitasking capabilities to run con¬ 
currently with other applications, eliminating 
the need for a dedicated database server. 
Watcom SQL uses the Open Database Con¬ 
nectivity standard for SQL database connec¬ 
tivity as its functional API, providing inter¬ 
operability with a range of front-end tools. It 
also offers application programming features 
such as bidirectional, scrollable, updatable 
cursors; updatable multitable views; binary 
large objects; self-tuning, cost-based query 
optimization; database compression; and 
multinational character set support. 

Watcom International 
Phone: (519) 886-3700 

UNIFACE. The company has announced the 
availability of UNIFACE tools that are opti¬ 
mized for IBM's DB2/2 and DB2/6000 rela- 
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tional database management systems. A new 
interface links the UNIFACE development 
system with DB2/2, DB2/6000, and host- 
based servers. The interface aims to provide 
transparent and simultaneous read /write 
access to DB2/6000 databases under AIX and 
DB2/2 databases under OS/2 and will sup¬ 
port host-based DB2 security, error handling, 
data integrity and recoverability, and all DB2 
data types. UNIFACE applications are 
designed to access many relational and non¬ 
relational data sources, including DB2/2, 
Rdb, INGRES, ORACLE, Sybase, and 
Microsoft SQL server. 

Uniface Corp. 

Phone: (510) 748-6025 

ESL Workbench 4.0. This OS/2-based integrat¬ 
ed development environment enables devel¬ 
opers to rapidly create simultaneous multi¬ 
ple-language client/server applications. New 
CUA extensions have been added, including 
spin button, slider control, and drag and drop 
to enhance graphical user interface develop¬ 
ment. Integration with Intersolv's PVCS mul¬ 
tideveloper support allows teams of develop¬ 
ers to simultaneously work on an application 
by version control and creation of archive 
files. ESL Workbench 4.0 also features the 
ESL Wizard, a visual programming tool that 
provides reusable code libraries and dynamic 
code generation. 

Easel Corp. 

Phone: (617) 221-2100, Fax: (617) 221-3099 

AlertVIEW. The company has announced 
AlertVIEW for Lotus Notes, which is in¬ 
stalled on OS/2 Lotus Notes servers to report 
replication, server, security, statistics, mail, 
and communication events. This agent 
detects errors that are not reported in the 
standard error log and also reports errors 
from remote Notes servers connected using 
dial-up services. 


Shany Inc. 

Phone: (415) 694-7410, Fax: (415) 694-4728 

AutoTester 2.0. Just released for the OS/2 Pre¬ 
sentation Manager operating system, Auto- 
Tester 2.0 is a testing and verification tool for 
graphical user interface applications. The 
software provides word-processing type edit¬ 
ing of tests, including familiar features such 
as cut/copy/paste, find/replace, and ad¬ 
justable fonts. The primary focus of the Auto- 
Tester 2.0 release is the introduction of Auto- 
Command, which generates a documented 
automated test instead of recording only a 
series of keystrokes and mouse events. 

AutoTester Inc. 

Phone: (800) 328-1196 or (214) 368-1196 

Subpanes/v. The company has added 20 new 
controls to this library of controls for 
Smalltalk/V and WindowBuilder Pro/V. The 
new controls include columnar list box. Table 
Pane, Bitmap Pane, Bitmap Button, Sliders, 
Gauges, 3-D Frames, HierarchicalListBox, 
DateEditor, TimeEditor, and NumberEditor. 

Objectshare Systems Inc. 

Phone: (408) 970-7280, Fax: (408) 970-7282 
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Touch-screen technology has made it possible to deploy automation where it was previously thought 
impossible. Doing so has required some rethinking of the user interface. To enhance usability, speed and 
ease of use were given paramount consideration. But it all relies upon hardware to provide an intuitive 
pen or touch "feel." By the CUBS TEAM—ROLANDO ARQUIZA, JERRY BAYER, LARRY GAVIN, BRIAN 
NORQUIST, AND JIM ZEIDEL 


OS/2 Survives the Pits! 


r hey said it couldn't be done* 
'impossible!" "Not in our trading 
pits/' But they were wrong. For 
well over a year now, a number of floor 
brokers in Chicago have been using 
OS/2 with pen based technology, right 
in the heart of the Chicago Mercantile 
Exchange's (CME) future trading pits. 

CHICAGO'S CUBS 

The system the brokers are using is 
called CUBS, the CME Universal Broker 
Station. This system, in conjunction with 
its front-end processor, allows firms 
located around the world to route or¬ 
ders directly to brokers 
in the pit. The system 
also provides the broker 
with deck management, 
execution, and endorse¬ 
ment capabilities that 
instantly inform the firm 
whenever a trade has 
taken place. Compared 
to the current manual 
system, CUBS offers a 
number of advantages as it takes recent 
computing technology where it has 
never gone before—the pits. 

LIFE IN THE PITS 

It was easy, however, to see why the 
skeptics felt the way they did; the 



(l-r) Brian Norquist , Rolando Arquiza, 
Larry Gavin, Jerry Bayer 


Chicago-styled open outcry method of 
trading is very physically and mentally 
demanding. If you have not seen these 
trading pits on television or in the 
movies, it may be difficult to imagine 
what it's like. 

Picture yourself in a jam-packed 
elevator, shoulder to shoulder, chest to 
back with people. Add the element of 
chaotic market swings, where fortunes 
can be made or lost in a matter of min¬ 
utes. And remember that you are in 
direct competition with everyone 
around you in getting off your order. 
That means being seen and heard first. 
You have to stay alert and act fast- 
very fast 

This is the "major league" of trad¬ 
ing. On some days, the Chicago Mer¬ 
cantile Exchange executes over two 
million contracts. That represents over 
two trillion dollars in underlying con¬ 
tract value. That's more than the entire 
U.S. government budget for a year 
changing hands in a single day! This is 
how worldwide businesses insure 
themselves against market risk. This is 
where the business world turns to 
secure some stability for decision mak¬ 
ing. And at this level, you can be sure 
CME impacts your life in untold ways, 
even if you have never heard of 
futures. 
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INTRODUCING OS/2 PEN TECHNOLOGY 

It is in this environment that OS/2 with 
touch-screen technology has found a 
home. Why? Because this technology 
can stay alert and act very fast. This 
technology is the preemptive design of 
OS/2 coupled with its multitasking/ 
multithreading capabilities. All of which 
is presented to the user via a natural¬ 
feeling, responsive touch screen. Ob¬ 
viously, the traditional keyboard and 
mouse cannot be used effectively in this 
environment. Without pen technology, 
this application would never have been 
conceived. 

It's that high-pressured, time-criti¬ 
cal, physically draining environment 
that demands an application that is intu¬ 
itive to use—right down to the feel of 
the pen on the screen. Anything less 
would be technology hindering, not 
helping, the broker 

For example, a lesser operating sys¬ 
tem might pause momentarily while 
simultaneously: 

* Receiving orders from as many as 80 
firms 

* Updating the window of open orders 

* Displaying a continuous stream of 
market quotes 

* Printing an endorsement ticket. 

If a pause occurs as the broker tries 
to register a trade, the broker may try 
again, entering a second double-dick. 
So when the system returns to process 
the user input queue, it might actually 
kick off two trades. This would cause 
confusion at the worst possible time— 
when the broker is most busy. At the 
very least it might require the broker 
to wait, distracting the broker's atten¬ 
tion. All of this is unacceptable: the 
broker s livelihood depends on paying 
complete attention to the trading pit, 
not on wrestling with some piece of 
equipment. 

CUBS avoids these pitfalls. Using 
OS/2 s preemptive operating system. 


user input is given highest priority, re¬ 
turning the necessary visual feedback 
immediately, while the other multi¬ 
threaded tasks are efficiently completed 
simultaneously. 

ITS PERFECT! 

The results speak for themselves. 
According to Ed Zegar, vice president of 
GSA and one of CME's CUBS brokers, 
"Its perfect!" But to get that kind of re¬ 
sponse from our users required not only 
OS/2 and IBM's touch screens but also a 
close working relationship with users in 
order to fine-tune the application. 

AN ENDORSEMENT FOR HANDWRITING 

At first the system was designed so that 
push buttons were used for everything. 
But during mock trading sessions, we 
soon found that—surprise!—the traders 
were accustomed to using a pen as a 
pen, not just as a pointing device. They 
wanted to write out their endorsements, 
not use push buttons. An endorsement 
consists of: 

* The actual execution price 

* The opposite broker(s) 

* The opposite broker's house 

* Some other information. 

However, a push-button approach 
does not duplicate the nuances of written 
endorsements. Every written endorse¬ 
ment is slightly different. Thus, if a broker 



A broker's CUBS screen used in the pits 
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is interrupted in the middle of writ¬ 
ing an endorsement—say, to exe¬ 
cute a trade—the broker could look 
at the first stroke on the screen and 
recall the transaction along with 
related information. 

Looking at nicely printed text 
generated from pushed buttons 
does not invoke the same level of 
recall. One transaction looks simi¬ 
lar to another. This recall capability 
is important since it allows brokers 
to be interrupted many times and 
to queue endorsements in their 
heads while more immediate tasks 
are addressed. The ability to do 
this lets brokers act very fast when 
trading. 


THE NATURAL WAY 

Capturing handwriting is more 
like the way brokers have been 
doing their jobs for years. It works, 


// BUTTON OOVN CODE 

PFNWP buttonProc = NULL; 

/**♦**♦♦♦♦**♦♦♦*♦****♦*♦*♦***♦♦*******♦*♦*♦♦***♦****♦♦♦**♦♦♦♦**♦»*♦♦**♦**♦ 

* 

* FUNCTION: RegisterButtonDwnCLass 

* The function registers a window class that is a subclasses of the 

* WC.BUTTON window proc. It changes the buttons response to 

* VN.BUTT0N1D0VN and WM.BUTT0N1UP. It changes the button proc to 

* produce a WM.COMHAND on the location of WH BUTT0N1D0WN not on 

* WH.BUTT0N1UP. 


* ****♦***♦***********♦***♦♦*♦**♦*♦♦*********♦*****♦**********♦*♦*♦***♦♦*/ 
BOOL EXPENTRY RegisterButtonDwnCLass( HAB hab ) 

CLASSINFO classinfo; 
if ( buttonProc = NULL ) 

{ 

if ( WinQueryCLassInfof hab, (PSZ) WC.BUTTON, Aclassinfo ) ) 

buttonProc = classinfo.pfnWindowProc; 
classinfo.flCLassStyle ft= "CS.PUBLIC; 

Figure 1 . Button down code (continued on page 88) 


Wed like To dispel a couple of 
myths about client/server testing. 


Myth # I: Client/Server testing is easy. 

New development tools make building client/ 
server applications easier than ever. The problem 
is, they’re harder to test, and you just can't stand 
up to them with manual testing methods. You 
need ATF, the only testing product designed for 
client/server. 

Myth # 2: Gient/Server testing is impossible. 

Testing client/server applications can be daunting. 
The problem is, your tests need to replicate real- 
world conditions, and you just can't do that with a 
stand-alone testing product. You need ATF, the 
only testing product designed for client/server. 

The Softbridge Automated Test Facility's unique 
architecture makes it the only product for true 
client/server testing of OS/2 and Windows apps. 

To learn more about ATF, call 617-576-2257. 

(Or FAX 617-864-7747.) 

If you're coming to OS/2 World in Santa Clara 
this July, stop by Booth 615 for an ATF demo. 

There's only one way to test client/server 
applications, and that's with ATF. 

Lc\J Softbridge, Inc. a 125 CambridgeParkDrive a Cambridge, MA 02140 
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Quadron’s OS/2 
development tools 
team up with IBM 
ARTIC co-processor cards to give you flexibility, 
communication power, and development speed. 


Cut your development 




Communication 



Use Quadron software and ARTIC 
cards to gain extra ports and 
enhance host PC per¬ 
formance by moving 
protocol processings 
the cards. Develop 
standard and custom 
communications for 
async. BISYNC, HDLC, 

X.25, LAP-B, or your own special 
protocol. And if you need more 
than one protocol, no problem- 
just run them at the same time on 
the same card. 

Programmers feel right at home 
with our software. Just program in 
standard C, and use our messag¬ 
ing API to link OS/2 threads with 


tasks on the card. Then check it 
out with our symbolic debugger 
and real-time analysis tools in 
OS/2 windows. 

Our easy-to-use software 
serves applications as diverse as 
telephone switching, financial 
transactions, satellite commu¬ 
nications, and process control. If 
any of this sounds like a match for 
your needs, call us today. 

Quadron 

' ^ 209 East Victoria Street 
Santa Barbara, CA 93101 
Fax: 805-966-7630 

805-966-6424 
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and they want to keep doing it that 
way. Technology should serve the 
user, not the other way around. So, 
we changed the application to cap¬ 
ture their handwriting. The bro¬ 
kers love it, 

ITS GOTTA BE COLOR 

Color also plays a large role. At 
first, only black and white screens 
were used. They worked, but as 
soon as the brokers saw the color 
units, they no longer wanted the 
black and white screens. Color 
gives important visual feedback. 
The user does not have to read 
words on the screen. Blue means a 
buy order, and red means a sell 
order. Brokers do not have to read 
the words to know what side of 
the market they are on. This saves 
time when they are entering and 
filling orders. 


On the black and white units, 
this critical distinction is not as 
obvious. Color, therefore, lets bro¬ 
kers act quickly and avoid costly 
mistakes. 

LET YOUR FINGERS DO THE TRADING 

On some of the candidate touch 
screens, a unique and dedicated 
pen was required. Brokers could 
not use those systems if they lost 
their pens or if their pens stopped 
working for some reason. To guard 
against this, the units deployed are 
both pen- and finger-sensitive. If 
brokers lose their pens, they can 
use their fingers, (Sometimes in the 
pits, brokers have to be careful 
about losing fingers as well!) 


tons; they had to be large enough 
for a gorilla's finger! Although 
this eats up valuable screen geog¬ 
raphy, it has the advantage of 
providing a large landing area. 
Users appreciate this even when 
they are using a pen. 

To make it even easier to use 
the touch screen—especially when 
brokers are being jostled around 
during fast markets—the buttons 
had to be subclassed to register a 
touchdown even though the bro¬ 
ker's pen or finger slid off before it 
was picked up. This is not stan¬ 
dard CUA protocol, but in this 
environment, it's what works. 
Figures 1 and 2 show how that 
subclassing was done. 



MAKE THOSE BUTTONS BIG / 

One important aspect of the user 
interface was the size of the but¬ 


BUTTONS FOR BARS 

To further the idea of large, easy- 
to-hit touch areas, we used a row 


• MAY THE . •- 
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BE WITH 



Don't let the dark torces of ignorance 
defeat you, Tap into the free CONSUMER . 
INFORMATION CATALOG - the source for 
more than 200 free and low-cost 

* government publications on cosmic 
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careers and government benefits. Just 
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Consumer Information Center 
• Department Source 

- Pueblo, Colorado 81009 

* * 


Transitioning to Smalltalk technology? 
Introducing Smalltalk to your organization? 

Travel with the team that knows the way... 

The Object People 
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of buttons painted across the top 
of the windows to support vari¬ 
ous activities instead of the stan¬ 
dard action bar. Instead of the 
standard action pull down menu, 
a column of easy-to-hit buttons 
appears* Figure 2 shows how we 
did this* 


OTHER THINGS 
LEARNED ALONG THE WAY 

During the mock training sessions, 
we were surprised to learn that 
some people have a difficult time 
double-clicking with a pen. Others 
seem to do it naturally So the sys¬ 
tem was designed to have large 
''buy" or "sell" buttons on it for 
those who would prefer the one- 
button, one-click approach* 

HAVE IT YOUR WAY 

We used command-line parame¬ 
ters for situations that do not 
change dynamically and user- 
definable buttons for those situa¬ 
tions that do* For example, our 
keypad has user-definable but¬ 
tons for quantities; touching a 1 
and then a 0 button is not as fast 
as a single touch of a 10 button. 
Later, when brokers are trading 
25 lots more often, we can reset 
that user-definable button to 25 
on the fly 

In another example, our 
numeric keypad has a command¬ 
line parameter for left- or right- 



Figure f. Button down code (continued from page 86) 


// BUTTON MENU code 

#define FID.BUTTQNHENU 0x8016 

/* numerically greater than FIELCLIENT */ 

PFNVP 

buttonMenuF rameProc; 

/* original procedure from the subclass 

INT 

buttonMenuHeight; 

* procedure of the button menu */ 

/* used in CubFormatFrameSubProc */ 

PFNWP 

formatFrameProc; 

/* window procedure of standard frame 

HWND 

hwndButtonMenu; 

* window as subclassed for the cub 

* button menu */ 

/* Frame Button Menu Window handle */ 

SIZEL 

si?lButton; 

/* default button size */ 

SIZEL 

sizlButtonSpacing; 

/* space between buttons */ 



Figure 2. Button menu code (continued on page 89) 
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* FUNCTION: CubCreateButtonMenu 

* This Function creates a button menu that returns all WM^COMMANDs 

* to its owner, listing a menu as the source of the command. 

itt*******M**$****tt******t**tt***f*****#**4*t**#**^***#4**4**f*t****#/ 

HWND EXPENTRY CubCreateButtonMenu( HWNO hwndParentFrame, HWNO hwndQwner ) 

{ 

COLOR backgroundColor; 

FRAMECDATA fcdata; 

FONTMETRICS fm; 

HAB hab; 

HPS hps; 

SEEL sizlPS; 

hab - WinQueryAnchorBlockt hwndParentFrame ); 

formatFrameProc = Win$ubclassWindow( hwndParentFrame, 

(PFNWP)CubFormatFrameSubProc ); 


fcdata,cb = $izeof( FRAMECDATA ); 

fcdata,flCreateFlags = FCFJQBYTEALIGN I FCFJOROER; 

fcdata.hmodResources - 0; 

fcdata,idResourees = FID_BUTTONMENU; 

hwndButtonMenu = yinCreate¥indow{ hvndParentFrame, 

WC.FRAME, 

NULL, 

WSJISI8LE I W$_CLIPSIBLINGS, 

0, 0, 0, 0, 

hwndOwner, 

HWNO TOP, 

FID.BUTTONMENU, 

fefcdata, 

NULL ); 

if ( hwndButtonMenu != (HWND)GL ) 

{ 

buttonMenuFrameProc = WinSubclassWindowC hwndButtonMenu, 

{PFNWP)CubButtonMenuSubProc); 

backgroundColor - WinQuerySysColorC HWND_DESKTOP, $Y$CLR_SHADQU, Ot ); 
WinSetPresParam( hwndButtonMenu, 

PP BACKGROUNDCOLOR, 

(ULONG) sizeoft COLOR ), 

^backgroundColor ); 

hps = WinGetPS( hwndButtonMenu ); 

Gpif)ueryFontMetrics{ hps, sizeof(FONTMETRICS), ftfm ); 
avgUpperCharWidth - (INT) fm,lEmInc; 

/* use default presentation space page size */ 

sizlPS. cx = 0; 
sizlPS.cy " 0; 

/* use standard english units for sizing, but convert into pixels for 

* speed, in units of 0.001 inches */ 

GpiSetPS{ hps, ftsizlPS, PU.HIENGLISH ); 

/* s izTB utton is considered to be the minimum size for a finger touch 

* on the screen. It is used to set the size of the button menu. */ 
sizlButton.cx = 597; 

sizlButton,cy = 479; 

GpiConvertC hps, 

CVTCPAGE, 

CVTC DEVICE, 

1L, 

(PPOINTL) fesizlButton ); 


Figure 2. Button menu code (continued on page 90) 
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sizIButtonSpacing.cx = 33; 
sizlButtonSpacing,cy - 33; 

GpiConvert( hps, 

CVTC_PAGE, 

CVTC_DEVICE, 

1U 

(PPOIKTL) IfcsizlButtonSpacing ); 

WinfteleasePSC hps ); 

buttonMenuHelght = (SHORT) (sizlButton.cy + 

(2 * sizlButtcnSpacing*cy)); 

return hyndButtonMenu; 

} 

/ft*********************************************************************** 

* FUNCTION: CubButtonMenuStibProc 

* Although this is a subproc, it performs all the basic logic for 

* button menus* It lets the default frame proc handle the basic stuff. 
*t*********^********************************t***************************/ 
MRESULT EXPENTRY CubButtonHenuSubProct HWND hynd, USHQRT message, 

^ HPARAM mpl, MPARAM mp2 ) 

HWND hundOvner; 

HWND hyndParent; 

switch { message ) 

{ 

case WM_CDMMANDr 

fa make sure the source is menu */ 

hyndOwner = VinQueryWindoy( hynd, QW^QWNER, FALSE ); 

WinSendNsg( hwndOyner, 
message, 
mpl, 

HPFRON2SHORK CHDSRC.HEHU, SH0RT2FR0HHP(mp2) ) ); 

return MRFR0HL0KG( OL ); 
case WM.CHAR: 

if ( {! (CHARMSG(&message)->fs t KC KEYUP)) 

M (CH A RH5G(ftmessage}->fs k KCJIRTUALKEY) 

M (CHARM5G(&rnessage)->vkey = YK.ESC) ) 

hyndParent = WinQueryWindoy( hynd, QW.PARENT, FALSE ); 
Win$etFocus( HWND_DESKTDP, 

WinWindowFromID( hyndParent, FID.CLIENT ) ); 

return ({*buttonMenuFrameProc){ hwnd, message, mpl, mp2 )); 
case WM_QUERYDLGCODE: 

return (MRESULT) DLGCJENU; 

default : 

return {{*buttonHenuFrameProe)( hynd, message, mpl, mp2 )); 

} 

* FUNCTION: CubFormatFrameSubProc 

* Intercepts WN.FGRHATFRAHE and WM.QUERYFRAMECTICQUNT messages from a 

* standard frame yindoy and adds the CubButtonMenu to the format, 
t************************************************************************/ 

MRESULT EXPENTRY CubFormatFrameSubProc (hwndFrame, message, mpl, mp2) 

HWND hwndFrame; 


Figure Z Button down code (continued on page 91} 
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USHORT message; 

MPARAM mpi; 

MRARAM mp2; 

{ 

USHORT cFrameControls; 
switch(message) 

case WM_qilERYFRAMECTLCOUNT: 

cFrameControls = SH0RT1FR0MMR{ {*formatFrameProc){ hwndFrame, 

message, 

mplf 

mp2 ) ); 

cFrameControls ++ ; 

return MRFROM$HQRT( cFrameControls ); 
case WH.FORHATFRAHE : 

(*formatFrameProc)( hwndFrame, message, mpl, mp2 ); 
cFrameControls = FormatFrameControlsf hwndFrame, mpl, mp2 }; 
return MRFRQMSHORT( cFrameControls ); 

default : 

return ((*formatFrameProc)( hwndFrame, message, mpl, mp2 )); 

> 

> 

^*************************************************************************** 

* FUNCTION: FormatFrameControls 

* 

* Responds to a WM_FORMATFRAME message by decreasing the size of the 

* client window, in order to add a button menu to the frame window, 

* Calls WinFormatFrame and WinSetMultVindowPQS. 
************************************************************************«*«/ 
USHORT PASCAL FormatFrameControlsf HtfND hwndFrame, MPARAM mpl, MPARAM mp2 ) 

{ 

PSWP aSwp; 

USHORT cSwp; 

HAB hab; 

HWND hwndQient; 

USHORT index; 

hwndCXient " WinWindowFromID( hwndFrame, FID^CLIENT ); 
hab - UinQueryAnchorBlock( hwndFrame ); 

aSwp = (PSWP) PVOIDFRDMMP( mpl ); 

for ( index = 0; (aSwp[indexLhwnd != hwndQient); index++ ); 

aSwp[(index + 1)] - a$wp[index]; 
cSwp = index + 2; 

aSwp[index],cy -= buttonMenuHeight; 
if( aSwptindex],cy >= 0 ) 

aSwp[(index + 1)].cy = buttonMenuHeight; 
else 
{ 

aSwp[(index + i)],cy - buttonMenuHeight + a$wp[index]-cy; 
aSwp[index],cy - 0; 

aSwp[(index + t)Ly = aSwp[index],y + a$wp[index],cy; 
aSwp[{index + l)].hwnd = hwndButtonMenu; 

WinSetHultWindowPos( hab, aSwp, cSwp ); 
return cSwp; 


Figure z Button down code (continued from page 30) 
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handed orientation. One person 
wants the numbers like a tele¬ 
phone pad with 1-2-3 at the top, 
another wants the opposite. 

Another important aspect 
about designing this touch-screen 
application was that keystrokes 
had to be minimized at every 
opportunity. Every time the broker 
has to touch a button or write on 
the screen, the broker's eyes would 
be diverted from the pit. We did 
not want this. So, we built in 
defaulted assumptions wherever 
possible. 

When it comes to touch-screen 
applications, programmers have to 
be prepared for supporting all 
kinds of user-to-user requirements. 
They have to be flexible. That flexi¬ 
bility must be built right into the 
application. 


SPEED KILLS? 

Speed is always essential, so the 
buttons in an activity have to be 
grouped close together. The bro¬ 
ker's hand must not fly all over the 
screen. 

For example, sometimes a bro¬ 
ker is in the act of writing out an 
endorsement in one window and 
receives an incoming order in 


another window. The problem is 
that the "accept" button is on the 
far side of the screen. Although 
this is where the broker usually 
wants it, in times like these the 
broker also wants another "accept" 
button nearby to save time, 

GIVE 'EM WHAT THEY 
WANT WHEN THEY NEED IT 

You cannot expect users to be com¬ 
puter literate. You cannot expect 
them to know how to size a win¬ 
dow or how use the title bar. If a 
window was expanded to take up 
the whole screen, the user could 
become confused. So we changed 
the windows so that the title bar is 
hidden unless it is specifically 
requested. It is embedded in the 
application in a turnkey way. 
Figure 3 shows that we concealed 
the frame controls, 

IN CONCLUSION 

Touch screen technology has 
opened up new areas for previ¬ 
ously untapped automation. This 
technology can be successful in 
environments few thought pos¬ 
sible. As you work to build the 
infrastructure for a better tomor¬ 
row, we hope our experiences and 


coding examples may be of some 
assistance. Have fun! 

Rolando Arquiza, senior programmer 
analyst joined the CUBS team recently 
His formidable background in Windows 
and OS/2 enable him to make significant 
contributions to the CUBS systems, 

Jerry Bayer r senior systems analyst, con¬ 
tributed greatly to the development of 
CUBS. Bayers expertise in OS/2 and com- 
munications has won him key roles on a 
number of critical projects at the CME. 

Larry Gavin, manager-systems develop¬ 
ment, has been on the CUBS project since 
its inception. His background in trading 
systems covers the major Chicago ex¬ 
changes including CBOE, CBOZ and CME. 

Brian Norquist, senior programmer ana¬ 
lyst, made critical contributions to the 
CUBS system. His extensive software 
engineering experience, including C++, 
positions him nicely as the lead developer. 

Jim Zeidel, director-systems develop¬ 
ment, has also been on the project since 
its inception. His extensive industry back¬ 
ground complements his responsibility 
over a number of trading systems used at 
both CBOT and CME. 



Figure 3. Hide title bar and frame controls (continued on page 93) 
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fFrameControlsHidden - TRUE; 


hyndTitleBar = Win Window FromI0( hwndFrame, FIt>_TTTL E8 ft R ); 
hwndSysHenu = VinWindouFromlDC hwndFrame, FID_SYSMENU ); 
hwndHinMax = UinWindouFromIO{ hwndFrame, FIO_HINMAX ); 

/* Hide by setting parent to the HWND_OBJECT window */ 

WinSetParent( hyndTitleBar, HWND.OBJECT, FALSE ); 

Win5etParervt( hwndSysHenu, HWND.QBJECT, FALSE ); 

WinSetParent( hwndMinHax, HWND_0BJ ECT, FALSE ); 

Win5endMsg( hwndFrame, 

WH.UPDATEFRAME, 

(HPARAH) (FCF.TITLEBAR I FCF.SYSMENU I FCFJtENHAX), 

NULL ); 

} 

* FUNCTION: ShowFrameControls 

* 

* Shoy the title bar and associated frame controls 

t***+********+^***************************t***************t*******+***t***/ 

VOID EXPENTRY ShowFrameControls( RWND hwndFrame ) 

{ 

fFrameControlsHidden = FALSE; 

/* reset parent of windows to the frame window, from HWND_OBJECT */ 
WinSetParent( hyndTitleBar, hwndFrame, FALSE ); 

WinSetParentf hwndSysHenu, hwndFrame, FALSE ); 

WinSetParenf( hwndHinMax, hwndFrame, FALSE }; 

WinSendtfsgt hwndFrame, VHJJPDATEFRAME, 

(HPARAH) (FCF_TTTLEBAR I FCF.SYSHENU | FCF.HINHAX), 

NULL ); 

/* highlight the title bar assuming the window is active */ 

WinSendKsg( hyndTitleBar, TBM.SETHILITE, 

MPFROMSHQRT( TRUE ), 

MPFROHLONG( OL )); 


/* force a redraw of added controls */ 
WinInvalidateRect( hwndFrame, NULL, TRUE ); 


/**^************* + ****:m****** + **** + ********** + **** + ***** + ******* + * + **+*** 

* FUNCTION: CubRestrictFrameSizing 

* This Function subclasses the frame window to prevent sizing when the 

* frame controls are hidden. 

^^t********^**^*t$^^t^^^^*****************t*^4*^t^^t ^f *****/ 

VOID EXPENTRY CubRestrictFrameSizing( HWND hwndFrame } 

{ 


} 


sizingFrameProc = WinSubdassWindow( hwndFrame, 

{PFNWP)CubFrameSizing$ubProc ); 


/*************$************************************************************* 
* FUNCTION: CubFrameSizingSubProc 






Figure 1 Hide title bar and frame controls (continued on page 94) 
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Intercepts WHJTRACKFR1ME messages from a standard frame window 
and prevents moving and sizing when frame controls are hidden* 

This procedure allows for disabling sizing even when the sizing 
* border is present. 

*************#*********t4*M***tt****4***t**********#*****t*******t**t**t/ 
HRESULT EXPENTRY CubFrameSizingSubProc( HWND hwndFrame, USHQRT message, 

mm mpi* mm mp2) 

switch ( message ) 

{ 

case WH_TRACKFRAME: 

if ( fFrameControlsHidden ) 
return WRFROMSHORT( FALSE ); 
else 

return ({*sizingFrameProcJ( hwndFrame, message, mpl, mp2 )); 
default : 

return ((*sizingFrameProc){ hwndFrame, message, mpi, mp2 )); 

> 

> 


Figure 1 Hide title bar and frame controls (continued from page 93} 



OS2TREE™ 

See your entire system graphically at a glance! 
"What XTREE GOLD is to DOS and More! 
And What Norton Commander Missed" 

* Completely programmable: every' functton/key can be 
customized! 

* Display your tree structure for all system and LAN disks 
concurrently! 

* Manipulate your files, directories, entire disks 
and/or entire system! 

* HPFS fully supported 

* Pop-up list of files for any directory 

* Edit/browse file(s) using any EDITOR or PROGRAM! 

* Extensive FILE Search and Tree directory search 
capabilities make locating files and/or data easy. 

* Upload/download files between mainframe and PC 

* Secure delete (sensitive files wiped clean) 

Intro Price: $7999 
Professional Version: $249*99 
Limited time special $ 150 (H) 

Network Licenses Available 

LEVINE COMPUTER 
CONSULTING SERVICES 

7640 Provincial Dr,, Suite 213, McLean, VA 22102 

Orders only (800) 383-9495 

FAX/Inquiries/HelpLine (703) 790-1660 


’ MAY THE ' 

• SOURCE 

BE WITH 


YOU 


t 


Don’t let the dark forces of ignorance 
defeat you. Right in this galaxy, you 
can tap into the source - the free 
Consumer Information Catalog. It lists 
free and low-cost government 

S '” itions on cosmic topics such as 
benefits, jobs, health, housing, 
educating your children, cars, and 
much, much more. So dispel the 
darkness and send for the source. 
Write today to Pueblo. Colorado for 
the free Consumer Information 
Catalog. Just send your name and 
• address to: 

Consumer Information Center 
* Department Source * 

Pueblo. Colorado 81009 * 


94 


OS/2 DEVELOPER 






Buyer 's Guide 



The staff of OS/2 Developer put together this special section to guide you through the various 
computer-based training programs available for OS/2. The products described in this guide are based on 
surveys sent to vendors; they are provided as a service to you and are free to vendors. These listings do 
not represent an endorsement by OS/2 Developer. Although every effort has been made to ensure accu¬ 
racy, we do not assume any responsibility for error or omission In this section. Please contact the compa¬ 
nies directly for more information. 


OS/2 Training 
Buyer's Guide 


AMERICAN TRAINING 
INTERNATIONAL Circle No. 130 

Teach Yourself OS/2 v2J is a self-paced, 
computer-based training program that 
allows both new and experienced users 
to master OS/2 in three to four hours. It 
features a split-screen approach to train¬ 
ing; the background screen simulates 
OS/2, while a special window provides 
interactive instruction to guide the user 
step by step through OS/2 procedures. 
The user reduces learning time and frus¬ 
tration by actually performing the skills 
and simultaneously seeing the effects of 
each keystroke. Price: $75.00. 

American Training International, 
12638 Beatrice St. y Los Angeles, Calif. 
90066, (800) 955-5284 or (310) 823-1129, 
fax (310) 827-1636. 

ONEONONE COMPUTER 
TRAINING Circle No, 131 

How to Use OS/2 version 2.x is a course on 
four audioeassettes of about two hours 
each that provides the beginning user 
with a hands-on orientation to the sys¬ 
tem: navigating the desktop, managing 
drives and directories, moving data 
between applications, and file editing. 
Data disk and quick reference guide are 
included. Price: $195.00. 

OneOnOne Computer Training, 
2055 Army Trail Rd., Dept. MF1, 


Addison, 111. 60101, (800) 424-8668 or 
(708) 628-0500, fax (708) 628-0550. 

USA TRAINING Circle No. 132 

Working with OS/2 version 2.1 is a four- to 
six-hour video course that focuses on 
features and functions of OS/2, includ¬ 
ing Workplace Shell's graphical inter¬ 
face. This course can help novices learn 
basic concepts and show experienced 
users how OS/2 differs from DOS and 
Windows. Price: $99.00. 

USA Training, 13515 Dulles Tech¬ 
nology Dr., Herndon, Va + 22071, (800) 
USA-2002 or (703) 713-3813, fax (703) 
713-0065. 

VIAGRAFIX Circle No. 133 

Getting Started with OS/2 gives an 
overview of OS/2, including multitask¬ 
ing, graphical interfacing, on-line infor¬ 
mation, Presentation Manager, and boot 
manager. It covers OS/2 fdisk and 
Workplace Shell use, migration, in¬ 
stalling and running various applica¬ 
tions, and understanding basic com¬ 
mands. Fifty Tour minutes. Price: $39.95. 

Productivity with OS/2 explains the 
path, the system editor, menus, folders, 
objects, associating programs with 
datafile objects, customizing programs, 
editing icons, adding parameters, 
manipulating objects, making objects 
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$5 





on a single issue of OS/2 


OS/2 Developer offers tips and 
techniques for more efficient com¬ 
puting for the advanced software 
developers who have recognized 
the need for 32-bit power. 


to on 


For new orders S customer service: 


T-0S2 


(1-800-926-86721 Or 

708-647-5960 
FAX (415) 905-2233 

Written subscription orders: 
OS/2 Developer • P 0 Box 1079 
Skokie. IL 60076-8079 


Subscription rates for G issues: 

□ U.S. - $39.95 

Canada —- $55.95 
International surface mail 

D International air mail $59.95 

Check inclosed 
Charge my: 

Visa MasterCard AmEx 


State/Zip 

Make checks payable to Miller Freeman. Inc, Foreign orders must be 
in U.S, funds. Please allow eight weeks for subscriptions to begin. 

HOUSAD 


from templates, exchanging data 
between sessions, printing, and 
running multiple applications. 
Eighty-seven minutes. Price: 
$49.95, 

OS/2 for your LAN defines local 
area network and gives an over¬ 
view of LAN server version 3,0. It 
addresses sharing resources, con¬ 
trolling LAN access, planning a 
network, software, hardware, and 
compatibility questions. It high¬ 
lights installing the server, re¬ 
quester, and the DOS LAN re¬ 
quester, It explains configuration 
concepts of the communication 
environment. Eighty-two minutes. 
Price: $59.95. 

Optimizing OS/2 for HOT 
Performance looks at CONFIG.SYS, 
the path and libpath commands, 
setting devices, modifying setup, 
and setting application environ¬ 
ment parameters. This video covers 
file settings, memory management, 
and processor performance. It pre¬ 
sents how to observe multitasking 
levels, reduce task switching opera¬ 
tions, improve file system, and 
speed up your system. Sixty-eight 
minutes. Price: $39.95. 

Each video comes with a learn¬ 
ing disk. Videos can be purchased 
individually or as a set; all four 
videos are $159.95. 

ViaGrafix, 5 S. Vann St, Pryor, 
Okla. 74361, (800) 842-4723 or (918) 
825-6700, fax (918) 825-6744. 
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if you're looking for a fuffy configurable, professional OS/2 PM 
programmer's editor to replace your current text-mode editor - we 
have what you have been looking fori 

No hassle changing editors 

We know changing editors can be a major hassle. You don't want to 
relearn a new set of keystrokes no matter how good the product 
Well, you don't have to - we have Brief, CUA, Epsilon, Multi-Edit 
SlrckEdit, PWB, and Borland IDE keyboard mappings waiting for you. If 
you're not using one of these, let us know and we will create the 
mapping you need. 

Features designed to increase productivity 

ft has all the features you have come to expect, plus special features 
designed to anticipateyour needs and increaseyour productivity. 
Features like a *C source browser that eliminates those time 
consuming searches for functions, global variables, typedefs, and 
macros by providing you with instant positioning to both definitions 
and references. Using our powerful 'C macro language you can 
customize your programming environment to suit your individual 
needs. 


Partial Feature List 

S Complete ANSI J C macro language 
y SyntaColor™—syntax highlighting 
y Smart C/C++ indenting & brace matching 
y Bookmarks 

y Unlimited undo and redo 
y Timed auto save 

y Access PDK help for function under cursor 
y Multithreaded for no waiting 
y Compile and jump to errors 
y I import/export to system c I i pboa rd 
y Keystroke record/playback 
y Block in den t/outdent 
y Hex editing 
y Customizable menus 

y Column, line and block 

selection, search and replace 

y Integrates with Workframe/2 

y Source browser for J C 

y Template editing 

y Mufti-buffer regufar expression 
search and replace 

y Support for version control 
y Complete on-line help 
/ Save and restore state between sessions 

y OS/2 2.x 32 bit PM Mufti-document 
interface 


'My copy of Brief has been permanently 
retired. Keep up the good workl" - AL 


RimStar Technology, Inc. 

91 Halls Mil! Road 
Newfields.NH 03856-0938 
Voice: (603) 778-2500 
Fax: (603)778-2408 


Price $299.00 

Plus Shipping & Handling. 

To order call 1 -600-746-7007 

60 day money-back guarantee, 


Al products end com perry ncmes ere 
trodemerta or registered 1radem<Tta of their 
iespectiue holders. RimSIici crxj SyntcColor 
ere trodemcite of RmSter Tedmotofly. he. 


© 1994 Technology Inc, 


Also avar/ato/e for lAtfndotvs and Window NT 
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The Borland Report on cross-platform development 


OWL is the cross-platform framework 
with the future built in 


AwWire tawititN 


i 


i 


i 


You're a programmer So when it 
comes to choosing a framework upon 
which to build your applications, you 
know that a good object-oriented 
design is critical to development suc¬ 
cess. Therein lies the difference 
between Borland’s ObjectWindows® 

Libraries (OWL) and Microsoft's 
Macro-based Foundation Classes 
(MFC). OWL is very object-oriented, 

MFC isn’t. 

MFC is not designed with the 
safety that exception handling and 
templates provide. And it's not archi¬ 
tect ured for the cross-platform future. 

OWL's superior architecture, inherent safety, and cross-platform 
advantage will make your development efforts more successful, 

OWL has over 200 object-oriented advantages 

Borland's leadership in object-oriented technology shines throughout 
OWL Unlike MFC, OWL is not just a thin veneer over Windows API 
calls. OWL delivers real benefits by increasing the reusability, reliability, 
and flexibility of your code. 

What does this mean in coding reality? Suppose you want to make 
a toolbar, If you want a black and white toolbar with 16x15 pixel 
bitmaps using default actions, OWL and MFC are about the same. But 
don’t be fooled. Suppose you need larger buttons? Suppose you need an 
edit field in your toolbar? Or you need to add new functionality to a sta¬ 
tus bar? OWL gives you immediate object-oriented flexibility, 
MFC doesn't. 

And this is just one example. With over 200 classes, 
encapsulating everything ranging from display contexts 
to print preview windows, OWL will keep you on the 
object-oriented fast track. 



“OWL isn t just a simple wrapper around Windows API. 
It is a well-designed class library in 
the fullest sense of the word. 

Anything that MFC can do, OWL can do better " 

1994—-Software Development Magazine 


unexpected happens, you have 
the power of C++ backing you up. 
You can easily add specialized 
error handling. You can easily 
correct problems. All without 
inelegant return value checks and 
other “out of date" error 
approaches. And if you don't 
write your own handlers, OWL's 
built-in handlers will take care of 
the problems for you, with full 
stack unwinding and destructor 
calling, for safe cleanup. 


Get the cross-platform advantage 

ObjectWindows 2.0 is the foundation for ObjectWindows for 
AppWare, a true cross-platform solution for Windows, Windows NT, 
Chicago, OS/2,® Macintosh, and UNIX. So you develop your code 
once, and deploy it on whatever platforms you need. While at the same 
time leveraging the capabilities of each target platform. 

OWL for AppWare is being built upon two proven, successful 
products, ObjectWindows and Novell's AppWare Foundation. Join the 
ObjectWindows for AppWare Early Experience Program and get 
started with cross-platform development today. 


Buy Borland C+ 
ST. FREE 


Training Course 
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Be safe 

If your code is your livelihood, you want 
to make sure your code is safe. No questions. 
OWL is designed from the ground up with 
exception handling built in. So if something 


Borland gives you easy access 
to the information you need 

Download the full 60-page OWL vs. MFC 
comparison paper from one of these on-line services: 

• Borland Forums on CompuServe, BIX, GEnie 

• Borland Bulletin Board (408) 431 -5096 

• Through Internet via anonymous ftp at flp.borlandeom 

Join the OWL for AppWare Early Experience Program 
- Call now (408)431-1507 

Subscribe to Borland's free electronic newsletter and get 
a regular update on the hottest programming tips and tricks, 
* For more information, send an electronic 
mail to tedi-info@borland,com 

Buy Borland C++ Today and pul OWL 2,0 to work 

The Upsizing Company foryou , 1-800-645-4559, ext. 8930 



Borland 


CALL NOW 1-800-645-4559, EXT. 8930 
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